Re: Gluster Documentation Update

[Humble Devassy Chirammal <humble.devassy@xxxxxxxxx>]

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@xxxxxxxxx> 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@xxxxxxxxxxx
http://www.gluster.org/mailman/listinfo/gluster-users

_______________________________________________
Gluster-users mailing list
Gluster-users@xxxxxxxxxxx
http://www.gluster.org/mailman/listinfo/gluster-users