Skip to main content
Jump to: navigation, search

Papyrus/Oxygen Work Description/Refactoring/DocumentationRefactoring

< Papyrus‎ | Oxygen Work Description
Revision as of 09:10, 9 December 2016 by Quentin.lemenez.cea.fr (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Documentation Refactoring

The Documentation of papyrus should get an overall refactoring, be it on its visualization or its location.


Description

This work will follow the following steps:

  1. Find out the existing state of the documentation and the extent of the work to be done.
  2. Remove outdated and therefore not useful, and at worse confusing, documentation leftovers.
  3. Update the documentation to the newest user interface and functionalities when possible.
  4. Create a common visual chart that future documentation attempts will have to respect. This taking form as Wiki and plugin charts in order to federate all documentations and improve the user experience.


As a guideline here are subsequent steps that should be taken if possible:

  1. Trim the existing wiki pages to extract their content inside documentation plugins in order to regroup all the information provided and avoid having to check multiple mediums to get the information available.
  2. Dissociate the user and developer doc to present the clearest picture available and the most adapted to each's expectations.
  3. Generate the documentation automatically during weekly builds.


Contributions

A first draft of the doc example plugin can be found here. And the related wiki page here.

Back to the top
https://wiki.eclipse.org/index.php?title=Papyrus/Oxygen_Work_Description/Refactoring/DocumentationRefactoring&oldid=412649
wiki.eclipse.org
CC-MAIN-2023-23
31033
application/http; msgtype=response
sha1:BJ4IR2FKXN6QJOFYH7V67BFKNTYZP42Q
<urn:uuid:abe2f8a5-7e20-46e0-b464-bbddcabde465>
2023-06-08T15:51:28Z
198.41.30.195
text/html
sha1:73H4YWKG6PSLIJRUAZIVRMZJGDPPMH46
<urn:uuid:16f03b30-b453-43a0-94b0-131e8c89176d>
https://wiki.eclipse.org/index.php?title=Papyrus/Oxygen_Work_Description/Refactoring/DocumentationRefactoring&oldid=412649
response
<urn:uuid:38936b1f-1e05-4ce8-b157-2e806cb72537>
isPartOf: CC-MAIN-2023-23
publisher: Common Crawl
description: Wide crawl of the web for May/June 2023
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-151
software: Apache Nutch 1.19 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.4-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: https://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/