[
https://issues.apache.org/jira/browse/CB-10448?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15118620#comment-15118620
]
Robert Posener commented on CB-10448:
-------------------------------------
I have attached a simple cut-and-past from my documentation style standards.
For context, the app that it is referring to (Project Success Mentor) is all
about Project Management... hence the preponderance of project management
terms. BTW, I have been a software Project Manager for the past 35+ years
(with a little bit of HTML/CSS and JavaScript on the side for the past 20
years). I'd think that many of these project management terms will be culled
for the final document, but I have left them in so that you can get a feel for
where we are going.
I think we will start out with quite a short list of spelling/terms, but as
contributors ponder "Do I spell it this way or that?", they will fire off an
e-mail and the resolution will be incorporated into this document for all to
see. Either that or a document reviewer will do the same.
I'd suggest that if everyone/anyone is OK with me moving forward on this, that
I take the existing Cordova documentation Style guides and merge them with mine
and then "publish" a more relevant document for people to then discuss.
Rob
> Cordova should have a styleguide
> --------------------------------
>
> Key: CB-10448
> URL: https://issues.apache.org/jira/browse/CB-10448
> Project: Apache Cordova
> Issue Type: Task
> Components: Docs
> Reporter: Dmitry Blotsky
> Attachments: Document Style Standards.HTML
>
> Original Estimate: 48h
> Remaining Estimate: 48h
>
> Languages it should cover:
> - JavaScript
> - Markdown
> - Java
> - Objective C
> - C#
> - JSON
> - YAML
> - CSS
> - HTML
> - English (voice, tense, etc.)
> The existing docs styleguide
> (https://github.com/MSOpenTech/cordova-docs/tree/master/doc) is a good
> starting point. Having /docs/styleguide/LANGUAGE.md is a potential way to
> organise it.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
