[Starlingx-discuss] StarlingX Documentation Initial Template

Waines, Greg Greg.Waines at windriver.com
Wed Aug 8 11:13:47 UTC 2018


Hi Abraham,

Will the documentation at https://docs.openstack.org/starlingx be both Developer Documentation and User Documentation ?

( I’m assuming that it will NOT be API documentation, I see discussions on that elsewhere.  And would be located at https://developer.openstack.org/api-ref/starlingx/ ??? )

I am the main reviewer for all existing User Documentation for Titanium Cloud,
so I’ll volunteer on being a core reviewer for this StarlingX Documentation ... please add me to the appropriate email lists.

Thanks,
Greg.


From: "Arce Moreno, Abraham" <abraham.arce.moreno at intel.com>
Date: Wednesday, August 1, 2018 at 11:54 AM
To: "starlingx-discuss at lists.starlingx.io" <starlingx-discuss at lists.starlingx.io>
Subject: [Starlingx-discuss] StarlingX Documentation Initial Template

Dean,

Here you have the high level overview of tasks to get started with our " StarlingX Documentation".
@Hayde has raised her hand to help in this short term not time consuming assignment.

Objective: Create a first "Gold Initial Commit" based in "Stx-Docs" project including high level requirements
from OpenStack Documentation Guidelines so it can ported into the rest of our StarlingX projects.

Phase 1:
1. Learning Resources
1.1 Read "OpenStack Documentation Contributor Guide"
       https://docs.openstack.org/doc-contrib-guide/index.html
2. Initial Code
2.1 Understand existing "Stx-Docs" repository and "docs/" implementation
       https://review.openstack.org/#/q/project:openstack/stx-docs
3. Translate important topics from "OpenStack Documentation Contributor Guide" into "Stx-Docs" commits:
3.1 Project guide setup
3.2 Writing documentation
3.3 Writing style
3.4 Building documentation
3.5 Landing pages on docs.openstack.org
4. Get Final Gerrit Reviews on commits and make changes
5. Have our "Gold Initial Commit" ready

Phase 2:
Once the first interaction is done we can take another repository to test our "Gold Initial Commit"
having only modifications at the content level.

Phase 3:
With 2 interactions we are ready to easily move what we have learned and implemented in 2 projects to
the rest of our StarlingX projects.

Happy to hear your thoughts.


_______________________________________________
Starlingx-discuss mailing list
Starlingx-discuss at lists.starlingx.io<mailto:Starlingx-discuss at lists.starlingx.io>
http://lists.starlingx.io/cgi-bin/mailman/listinfo/starlingx-discuss

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.starlingx.io/pipermail/starlingx-discuss/attachments/20180808/83059296/attachment-0001.html>


More information about the Starlingx-discuss mailing list