[Gluster-infra] [Gluster-users] Working but some issues

Vijay Bellur vbellur at redhat.com
Tue Mar 17 17:01:12 UTC 2015


On 03/17/2015 09:30 PM, Joe Julian wrote:
> On 03/17/2015 06:47 AM, Glenn Holmer wrote:
>> On 03/17/2015 01:43 AM, Joe Julian wrote:
>>> I'll split this out as I think you're unaware of the admin guide that's
>>> pretty detailed and is, at least, published with the source code (it may
>>> be on the gluster.org site somewhere, but I'm too tired right now to
>>> look). The source can readily be found on github
>>> <https://github.com/GlusterFS/glusterfs/tree/master/doc/admin-guide/en-US/markdown>.
>>>
>> As good as that guide is, I see that as an issue. The documentation page
>> has an "Administrator Guide" link that goes to... the markdown source on
>> github (same link you posted). Couldn't a PDF be built from that in CI
>> and linked to from the documentation page? It would be a lot easier to
>> use (and give a better impression than "here, look at the source").
>>
> Probably. Personally, I abhor pdf and wish it would die a fiery death.
> If I had my preference, the md would just be rendered into an html guide.

FWIW, I was able to render a rudimentary single page html guide by 
issuing the following command line:

pandoc -t html -o gluster_admin_guide.html glusterfs_introduction.md 
admin_start_stop_daemon.md admin_console.md admin_storage_pools.md 
admin_setting_volumes.md admin_managing_volumes.md 
admin_settingup_clients.md admin_monitoring_workload.md 
admin_directory_Quota.md admin_distributed_geo_rep.md 
admin_object_storage.md admin_managing_snapshots.md admin_ssl.md 
admin_troubleshooting.md did-you-know.md glossary.md

The result is available at [1]. This does not include all .md files, has 
some issues in rendering a few images and the documentation flow is not 
the best, but it possibly seems much better than whatever we have right 
now.

I don't think it would be too complex to evolve a jenkins job based on 
the above command line. Would somebody in gluster-infra with access to 
gluster.org and our jenkins installation be able to configure a daily 
job that does this conversion and roll it out on gluster.org?

Once we have this setup we can roll out various formats on to gluster.org.


-Vijay

[1] 
http://employees.org/~vbellur/glusterfs/admin-guide/20150317/gluster_admin_guide.html





More information about the Gluster-infra mailing list