How to Start a Portal

Key considerations:

• Depending on the project need, portals can be driven dynamically from Views or statically from Tables.

• External content that the portal renders within the site must be hyperlinked "https". Links out can be http or https.

• Removing facets can improve performance.

Jira

Portal development coordination is tracked in the Community Portals Jira project. Create an appropriate Epic to track the overall project. It is the job of the respective product manager to triage issues to the engineering team (Alina, Michael and Jay) appropriately.

What are the first steps?

1. A Synapse Project drives the backend of the portal. Make a project (e.g. PEC).

2. Define a url by opening a Jira issue with PORTALS (e.g. PEC).

3. Implement design by opening a Jira issue with PORTALS(e.g. PEC)

4. Create Table/View architecture

   1. Publications

      1. Set schema

      2. Tool to scrape Pubmed for relevant publications using grant or pubmed id as input

   2. People

      1. Set schema

   3. Study

      1. Set schema - note "hint text" is tracked in Confluence page and must be manually set by web developer

   4. General notes about table schemas and column types

      1. Simple markdown (links, bullets, bold, etc) is supported in underlying tables, but you will need to specify which columns have markdown in the schema

      2. if you need to link to multiple synapse IDs, separate the list with commas

Use these questions to guide conversation with the design team about the homepage:

1. Why/goals/value- what is the focus of this portal

2. Relationship to consortium

3. Fit in ecosystem

4. Type of resources available

5. Diversity within type/amount within type

6. Main actions- e.g. find data/tools/people

7. Progress and future-- living repo/freshness of data

8. FAQ/help