Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation Approach #98

Open
KipTwitchell opened this issue Feb 17, 2021 · 5 comments
Open

Documentation Approach #98

KipTwitchell opened this issue Feb 17, 2021 · 5 comments
Assignees
Labels

Comments

@KipTwitchell
Copy link
Member

@KipTwitchell KipTwitchell commented Feb 17, 2021

It is proposed that we consider use of Gatsby as the documentation tooling for web presentation. To be discussed at the TSC meeting in Feb.

Discussion should be had on User's Guide, Reference, Developer Guide, Impact, Design, etc.

Additional discussion to be held on DITA vs. MD as well.

@KipTwitchell
Copy link
Member Author

@KipTwitchell KipTwitchell commented Mar 10, 2021

TSC meeting discussion: question to Ian as to what the production ready process rather than if this is a prototype effort at this point.

Eugene walked the team through the choices between DITA to Markdown. His recommendation was to use Markdown as the approach we would use, primarily because of the possible of additional resources to help with documentation. Decision is made on Markdown.

Loading

@SaPeresi
Copy link
Member

@SaPeresi SaPeresi commented Mar 22, 2021

Ian would like to demo the website.

Loading

@AOrthVector
Copy link
Contributor

@AOrthVector AOrthVector commented Mar 24, 2021

Here's the link to the artwork created by OPM
https://github.com/openmainframeproject/artwork/tree/main/projects/genevaers

They are in the standard formats including svg

Loading

@SaPeresi
Copy link
Member

@SaPeresi SaPeresi commented Apr 14, 2021

discussed creating more data for orders to show large amount.

Loading

@KipTwitchell
Copy link
Member Author

@KipTwitchell KipTwitchell commented Apr 28, 2021

Looking for push of Gatsby pieces by the May 1st meeting. MIT license question about acknowledgment, Kip to Investigate that need.

Loading

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
4 participants