You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@ignite.apache.org by "Denis Magda (JIRA)" <ji...@apache.org> on 2018/01/31 23:18:00 UTC
[jira] [Created] (IGNITE-7595) Find and switch to alternate
documentation engine
Denis Magda created IGNITE-7595:
-----------------------------------
Summary: Find and switch to alternate documentation engine
Key: IGNITE-7595
URL: https://issues.apache.org/jira/browse/IGNITE-7595
Project: Ignite
Issue Type: Task
Reporter: Denis Magda
Assignee: Prachi Garg
Fix For: 2.5
Current readme.io documentation has many drawbacks that make the life of Ignite technical writers hard. Some of the problems are:
* Each "version" is just a copy of the previous one. When fixing something, you have to update
all the versions.
* No good way to review changes.
* "Propose edit" functionality is a not suitable for review. You can only accept or reject an
edit, no way to communicate with a contributor, etc
* There is no way to prevent Google from indexing old documentation versions. Thus, it's common to come across old doc version in a google search.
We might consider GitHub based documentation or another approach. The discussion is here:
http://apache-ignite-developers.2346864.n4.nabble.com/Move-documentation-from-readme-io-to-GitHub-pages-td16409.html
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)