[Gluster-users] Gluster Documentation Update

[Humble Devassy Chirammal]

HI Lindsay,

>
BTW, I still get a lot of dead links from the search on readthedocs
>

Can you please share couple of examples?

Because, if the dead links are formed due to recent rearrangement of docs,
it will be vanished soon. . That said, when we moved the documentation to
github based, we kept everything in github and rendered to readthedocs.
However, recently one more revisit happened on this approach and now the
documentation is mainly in 3 places.

*) Developer docuement : Inside gluster source code repo (
https://github.com/gluster/glusterfs/tree/master/*doc/developer-guide*)
*) Features/specs  :  https://github.com/gluster*/glusterfs-specs/*
*) Admin/user based : https://github.com/gluster/*glusterdocs*

If I am searching on a string (for ex: quota) in readthedocs  , below link
may come in the search result
http://gluster.readthedocs.org/en/latest/Features/quota-object-count/?highlight=quota

Above is a deadlink because "Features" directory itself is moved and its
now part of https://github.com/gluster/*glusterfs-specs*
/blob/master/done/Features/quota-object-count.md

Please let us know if you are facing the deadlink issue for some other
scenarios.





--Humble


On Thu, Dec 10, 2015 at 4:38 AM, Lindsay Mathieson <
lindsay.mathieson at gmail.com> wrote:

>
>
> On 10/12/2015 8:56 AM, Amye Scavarda wrote:
>
>> n the interest of making our documentation usable again, we've gone
>> through MediaWiki (the old community pages and documentation) and found out
>> what was left behind and what needed to be moved over to our Github-based
>> wiki pages. We'll be turning those live on Github this week, before
>> December 11th.
>>
>
> Brilliant, thanks.
>
> BTW, I still get a lot of dead links from the search on readthedocs
>
>
>> We'd love to make sure that we're not missing anything, so we'll leave
>> the MediaWiki up until January 1st, and work to consolidate our
>> documentation on ReadTheDocs moving forward.
>>
>> Let me know if you have questions or want to help QA this!
>>
>
>
> What would QA involve?
>
> --
> Lindsay Mathieson
>
> _______________________________________________
> Gluster-users mailing list
> Gluster-users at gluster.org
> http://www.gluster.org/mailman/listinfo/gluster-users
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.gluster.org/pipermail/gluster-users/attachments/20151210/8a70452f/attachment.html>