Here are some quick guidelines to make sure we pick up the right information for our users to search

• Use a separate overview page for the portfolio called company.com/portfolio and a separate page for the team called company.com/team.
• Use a separate profile page to provide more information about a portfolio company or team member. Include the link to this page on the overview page. If there are certain types of information that are not available for everyone, the profile page is the best place to provide this information.
• Use specific names for URLs that indicate what kind of information will be found on the page, like company.com/team/john-doe for the page that contains information about team member John Doe.
• Use the exact same HTML template to give information about a team member / portfolio company (ideally with all information specified for everyone) on the overview page and make sure at least the name is included for each of them.
• Use a nested HTML structure on the overview page. Ideally there is one HTML tag that contains the list of team members / portfolio companies and nothing aside from that, and different tags or CSS classes to denote the type of information, eg. h3 for the name, p for the job title, etc. This is not as important for links (like the website of the portfolio company, social media), because they are usually unique by domain anyway.
• Use good naming conventions, even in places that aren’t visible to the end user. For John Doe’s headshot, use a name like ../headshot_john_doe.jpg instead of ../img_3241.jpg.

Dont's

• Combine portfolio and team members on the same page (like the home page).
• Use modals (or anything dynamically loaded) to provide more information about portfolio companies or team members.
• Use generic names for URLs like company.com/john-doe (is it a team member or portfolio company called John Doe?) or company.com/team/member-1.
• Provide different types of information about team members or portfolio companies on the overview page (eg. job titles for some of the team members, this increases the risk of assigning the wrong information to the wrong person).