On Thu, Nov 23, 2017, at 11:46 AM, Akira TAGOH wrote:
On Thu, Nov 23, 2017 at 3:31 AM, Matthew Miller
<mattdm(a)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
> <mattdm(a)fedoraproject.org>
> Fedora Project Leader
> _______________________________________________
> devel mailing list -- devel(a)lists.fedoraproject.org
> To unsubscribe send an email to devel-leave(a)lists.fedoraproject.org>
--
Akira TAGOH
_______________________________________________
devel mailing list -- devel(a)lists.fedoraproject.org
To unsubscribe send an email to devel-leave(a)lists.fedoraproject.org