Re: feedback on release schedule rendered docs

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Tue, 9 Oct 2018, Noah Watkins wrote:
> As part of the documentation enhancement effort we've encountered a
> need to access to ceph release information in a machine readable
> format.
> 
> As a proof of concept we've converted the humongous release table
> (http://docs.ceph.com/docs/master/releases/schedule/) into a yaml file
> with a schema that is optimized for adding new releases, and use this
> a data source to render the html table and produce a json file used by
> the documentation project.

I like it!

> There is still a lot that needs to be fixed up, but now would be a
> good time to comment on the schema, the general direction of the
> rendered HTML (e.g. we've rotated the table so it's tall instead of
> wide), and any additional information that might be beneficial to
> track.
> 
> Release source:
>    https://github.com/ceph/ceph/blob/3a2a93351954585adbb912994d9d7ad306f35189/doc/releases/releases.yml
> 
> Sample rendering:
>    http://docs.ceph.com/ceph-prs/24452/releases/schedule/
> 

- Let's add a "latest" to the CURRENT section for each stable release
- We can drop "end of life" from the TIMELINE section

Is the timeline section being generated?  I see all of the old releases in 
the table but they're not in the source yaml.

sage



[Index of Archives]     [CEPH Users]     [Ceph Large]     [Information on CEPH]     [Linux BTRFS]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux