Petr Bokoc píše v Po 25. 03. 2019 v 17:46 +0100:
Hi,
that's a pretty good idea. Not sure about "about <product>", those
aren't being reused at all I think (we *could* do that with a bunch
of ifdefs, but for the love of everything that's holy let's not...),
but the legal notice or the feedback page would definitely benefit
from an arrangement like that.
Hi Petr,
Yes, both, legal notice and feedback, are clear. I was not sure about
the "about" things either. Maybe there will come other partials in the
future, but it will probably be a result of a slower evolution.
I keep saying that I am not sure how strong the use case is. ;)
I had also one question in mind, but I didn't want to go to much detail
in the introductory post. I don't have even idea where this "docs
common" partials should have a home - should it be their own
repository? If they should contain only two pages/files for the near
future, I was thinking of making them part of the
https://pagure.io/fedora-docs/template or maybe
https://pagure.io/fedora-docs/release-docs-home.
Anyway, thank you for answering my post and your will to take an
action.
Josef
I'll get on it let's say next week unless someone really
objects to
the idea.
Petr
On 3/23/19 6:01 PM, Josef Hruška wrote:
> Hello,
>
> I'd like to propose and discuss with you an idea to create a
> repository that would contain, let's say, partials which are likely
> to be reused in Fedora's docs. Today, I think of Feedback.adoc or
> Legal_Notice.adoc, for example. But it could be also
> "about_fedora", "about_silverblue", descriptions of
Fedora's
> flavors,...
>
> The thing is I am not sure how strong such a use case it is. Will
> 3-4 document components (partials) which will be reused in up to
> ten documents just suffice to make a discrete place (repository?
> module?) for them? Where is the threshold? Could it be less or
> rather more?
>
> I hope I didn't mistake myself and partials can be "xrefed" outside
> a module or even a repository.
>
> If the repository existed, it would IMO certainly facilitate also
> translations, for example (there could be, I assume, just one its
> translated sources).
>
> I don't count myself among you, the docs writers. I have been
> translating Fedora for few years. I've also been following your
> mail list since I first noticed proposals to leave Publican tool
> chain. And this idea has come to my mind very recently, when I try
> to follow in my modest capacity the effort to build the tooling
> around Antora.
>
> Please feel free to react for or against.
>
> Josef Hruska
> fas: peartown
>
>
>
>
> _______________________________________________
> docs mailing list -- docs(a)lists.fedoraproject.org
> To unsubscribe send an email to docs-leave(a)lists.fedoraproject.org
> Fedora Code of Conduct:
https://getfedora.org/code-of-conduct.html
> List Guidelines:
>
https://fedoraproject.org/wiki/Mailing_list_guidelines
> List Archives:
>
https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org
_______________________________________________
docs mailing list -- docs(a)lists.fedoraproject.org
To unsubscribe send an email to docs-leave(a)lists.fedoraproject.org
Fedora Code of Conduct:
https://getfedora.org/code-of-conduct.html
List Guidelines:
https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives:
https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org