On Thu, Nov 23, 2017, at 11:46 AM, Akira TAGOH wrote: > On Thu, Nov 23, 2017 at 3:31 AM, Matthew Miller > <mat...@fedoraproject.org> wrote: > > On Tue, Nov 21, 2017 at 03:44:05PM +0530, Akira TAGOH wrote: > >> All of fonts is supposed to have an information page for their > >> fonts> >> at wiki based on the template[1] according to the package > >> lifecycle[2]. however some of them doesn't have. so just tried > >> to pick> >> them up and inform you to get one there. > > > > Are they? From the lifecycle page you link, that seems to be > > there to> > enable the packaging of the font in the first place, not meant > > to be> > long-term documentation. If it _is_ meant to be long-term > > documentation, that should be clarified somewhere. Who is the > > audience> > for this documentation? > > That could be. as some of the wiki pages contains the sample > rendering, that should definitely be helpful for the end users too to> see > how it looks like. unfortunately not available everything. we > could improve it. > For the audience, I don't know.. maybe Nicolas Mailhot? > > > If it's supposed to be for end users (and that's a great goal!), I > > think the new docs site would be better than the wiki. > > Sure. yes, I like it. that depends what sort of information we provide> > though, the wiki pages can be easily outdated if noone maintains. so > maybe nice to have the sort of web apps or any infrastructure working> at the > background to generate information from the packages and so on.> well, we > could do that with wiki even though. i suspect we could do the same for the docs site. We could create a font catalog with sample rendered to images (I hope someone knows how to do this in an automated way). We could probably also gate showing a font based on some kind of a test (dnf to see if the package exists? Did the render succeed?). Lastly, we could theoretically trigger a republish based on both new pages added and fedmsgs about package updates. Regards, bex > > > > > If it's for contributors and packagers, wouldn't it be better > > to have> > the documentation in a README.md in dist-git, next to the spec > > file?> > That way, it'd show up at (for example) > > https://src.fedoraproject.org/rpms/overpass-fonts > > > > -- > > Matthew Miller > > <mat...@fedoraproject.org> > > Fedora Project Leader > > _______________________________________________ > > devel mailing list -- devel@lists.fedoraproject.org > > To unsubscribe send an email to devel-le...@lists.fedoraproject.org> > > > -- > Akira TAGOH > _______________________________________________ > devel mailing list -- devel@lists.fedoraproject.org > To unsubscribe send an email to devel-le...@lists.fedoraproject.org
_______________________________________________ devel mailing list -- devel@lists.fedoraproject.org To unsubscribe send an email to devel-le...@lists.fedoraproject.org