From mboxrd@z Thu Jan  1 00:00:00 1970
From: Vitaly Fertman <vitaly.fertman@seagate.com>
Date: Wed, 20 May 2015 21:06:45 +0300
Subject: [lustre-devel] lustre design docs
Message-ID: <69BD0579-A188-4012-8926-3F55CF5E1BF9@seagate.com>
List-Id: <lustre-devel-lustre.org>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
To: lustre-devel@lists.lustre.org

Hi All,

there was an idea to publish existing design docs on opensfs wiki.
is centralised design repository interesting at all?

currently the existing designs are not in the wiki format, mostly pdf, so this is
not an ideal doc repository we want to have: not changeable, not maintainable,
could be outdated, etc, but could be published very quickly.

however, this is not the final step but just a beginning. at the same time, we may get
some benefits immediately:
- all the docs are gathered in one centralised place, faster doc search;
- the fully documented product (although maybe not very up-to-date initially) ?
attractive for many readers, especially newbies;
- a quick jump to unknown code having a design, faster than reading the source code;

after that, having these docs already published, next steps could be:
- docs to be split on those which are to be maintained and left untouched;
- a procedure of converting to be maintained docs to wiki format could be organised; 
- a procedure of updating converted docs to be organised; 
etc.

would be valuable? thoughts?

?
Vitaly