FDC3 docs / sites
...
fdc3.finos.org - public facing documentation for users and evaluators of FDC3:
...
Pieces and sections
- The new FDC3 microsite to be launched as part of public launch: fdc3.finos.org
- What is the github / content management system supporting this? → Maurizio Pillitu
- Links to GitHub for code
- Links to ( ← when the new site is ready, www.fdc3.org will be redirected to the new microsite)
- GitHub for code repos (https://github.com/fdc3)
- FINOS Wiki, https://finosfoundation.atlassian.net/wiki/spaces/FDC3, for collaboration
- Docs sourced from Github
...
- FINOS web site program page
Required components of product (FDC3) microsite
- A business overview of the product (i.e., FDC3 standards), its value to organization, and an explanation of why businesses should implement it and/or
use/buy software that does implement it -- in layperson’s terms. (Key Message: "Your firm should deploy trader desktop applications, tools, and platforms that
comply with the FDC3 standards because...) - A technical overview of the standards, including any overview of opinionation, preferred design patterns, coding conventions, etc.
- An explanation of how to get involved and contribute (with a link over to the wiki for more information on program/WG participation)
- An explanation of how the standards (i.e., different work group products) are intended to be used together but also how they can be implemented as a standalone
- A “getting started” guide / cookbook to implementing the standard
- Links to reference implementations
Personas
- Developers and Technologists who might be interested in implementing a standard like FDC3 and/or will be expected to write code that leverages the standards
- Product managers and business architects of internal trading systems (either bought/deployed or homegrown/internally built)
- Project managers within financial services organizations who implement trader desktop systems, applications, and tools
- Executives and other project sponsors in the trading lines of business at banks
- Product managers for fintechs and other software companies whose products might be good candidates to adopt, either wholly or in part, the FDC3
- Consultants who may implement, customize, and/or develop software that uses FDC3 at/for their clients
What Gets Written Where and For Whom?
Target Persona | Program Level | Working Group Level | |
---|---|---|---|
Business Overview | Executives in Trading Functions / Bank Executives | Yes | Summary of commercial value of the particular working group standard and specifically what business problems for trading desktop intertop it solves |
Technical Overview | Developers | Yes, highlighting especially how the standards are used together | Yes, with examples of how a particular working group standards can be used alone |
Roadmap | All | Yes, Summary of overall roadmap for 2019 roadmap | Yes, summary that represents the backlog and major features, functions, and use cases that the working group will be working on? |
Getting Started / Implementation Guide | Developers (and project managers) | Yes | Specific configuration, coding conventions, tips, etc. to be included in the implementation guide |
How to Get Involved | Potential Contributors (Developers) | Yes | No (can be summarized and pitched at program level) |
https://github.com/FDC3
...
- Source code and master for documentation
README.md Requirements
(See Activation section of the Community Handbook for more info)
- “description of the software, including a feature overview”
- “installation & configuration instructions”
- “description of how to use the software”
- “links to other systems (further documentation, continuous integration & validation tools, artifact repository, change log / history, etc.)”
- “Foundation status badge (“Released” when all criteria are met and PMC approves)”
- “Roadmap”
- “copyright & license information”
https://finosfoundation.atlassian.net/wiki/spaces/FDC3
...
- "The Wiki" - Group collaboration for program participants/interest
The primary purpose of the wiki is to help manage the project teams developing FDC3
https://www.finos.org/fdc3 - Finos FDC3 intro:
- Links here go to - https://finosfoundation.atlassian.net/wiki/spaces/FDC3, should also include new landing page fdc3.finos.org
...
- Rob Underwood (Deactivated): Build overall documentation plan (this doc)
- Kick start documentation Taskforce (initiate: Espen)
- INTER-site Information Architecture - FINOS (Gabriele Columbro): Information Architecture
- What goes on FINOS.org program page for FDC3 and FINOS.org website more generally?
- What goes on wiki?
- What goes on fdc3.finos.org (fdc3.org), the "main" site, for the product?
- INTRA-Site Information Architecture / Navigation of the "main" micro-site,
- Is using the WG taxonomy an appropriate 1st level navigation construct? Are there better alternatives?
- fdc3.finos.org website?
- fdc3.finos.org website?
- Is using the WG taxonomy an appropriate 1st level navigation construct? Are there better alternatives?
- Rob Underwood (Deactivated): Perform Gap Analysis (What's Missing? What Needs to Get Updated) - Rob Underwood (Deactivated)
- Initial Gap Analysis (FINOS - Rob Underwood (Deactivated), Gabriele Columbro and Tosha Ellison) - In Progress (See Gap Analysis)
- What's not written and needs to be? Maurizio Pillitu Espen Overbye
- Explanation of how FDC3 can be consumed (how can it be used and implemented)
- What needs to be revised, expanded, and/or editeD?
- What's not written and needs to be? Maurizio Pillitu Espen Overbye
- Identify actions and remedies
- Initial Gap Analysis (FINOS - Rob Underwood (Deactivated), Gabriele Columbro and Tosha Ellison) - In Progress (See Gap Analysis)
- Agree / change the proposed structure (information architecture) above (PMC / Taskforce)
- brandingbranding Tosha Ellison Aaron Griswold
- Logo
- Color Palette
Develop new FINOS consistent FDC3 - Update template for fdc3.finos.org and sub groups (new Taskforce)
- Redirect fdc3.org to fdc3.finos.org (todo:OpenFin)
- Update https://www.finos.org/fdc3 to include links to new landing page (Todo:FINOS)
- Merge Mao’s pull requests into the different repo’s, after cleaning up the template and syncing links (todo: Mao + WG group leads)
- Update intro docs (landing page on fdc3.finos.org ) (new Taskforce)
...