Hi,
I wrote [1] to devel some time ago regarding the deprecation of the apps.fp.o index and plan to move its content to the main docs. Kevin mentionned that it could end up in the infrastructure docs and that the whole should be moved to docs.fp.o at some point. I will take a look at both since I have wanted to play with the new documentation pipeline for a while. I am not the best guy to meddle with the infrastructure doc but I might as well do something useful while playing with antora. Tell me if it's not or if I missed something.
I might have something to show you at Flock if I have troubles sleeping in the train.
[1] https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/...
See you in Budapest,
On Mon, 5 Aug 2019 at 11:28, Timothée Floure timothee.floure@posteo.net wrote:
Hi,
I wrote [1] to devel some time ago regarding the deprecation of the apps.fp.o index and plan to move its content to the main docs. Kevin mentionned that it could end up in the infrastructure docs and that the whole should be moved to docs.fp.o at some point. I will take a look at both since I have wanted to play with the new documentation pipeline for a while. I am not the best guy to meddle with the infrastructure doc but I might as well do something useful while playing with antora. Tell me if it's not or if I missed something.
Hi thanks for looking at this, We have started a CPE ( Community Platform Engineering) docs [0] with a bit of what this teams does and some of the process around ( this is not live yet)
Maybe moving the content of apps.fp.o there would be a good idea ?
[0] - https://pagure.io/cpe/docs
I might have something to show you at Flock if I have troubles sleeping in the train.
[1] https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/...
See you in Budapest,
-- Timothée _______________________________________________ infrastructure mailing list -- infrastructure@lists.fedoraproject.org To unsubscribe send an email to infrastructure-leave@lists.fedoraproject.org Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/infrastructure@lists.fedorapro...
On Mon, Aug 05, 2019 at 12:40:53PM +0200, Clement Verna wrote:
On Mon, 5 Aug 2019 at 11:28, Timothée Floure timothee.floure@posteo.net wrote:
Hi,
I wrote [1] to devel some time ago regarding the deprecation of the apps.fp.o index and plan to move its content to the main docs. Kevin mentionned that it could end up in the infrastructure docs and that the whole should be moved to docs.fp.o at some point. I will take a look at both since I have wanted to play with the new documentation pipeline for a while. I am not the best guy to meddle with the infrastructure doc but I might as well do something useful while playing with antora. Tell me if it's not or if I missed something.
Hi thanks for looking at this, We have started a CPE ( Community Platform Engineering) docs [0] with a bit of what this teams does and some of the process around ( this is not live yet)
It actually is live as of last Friday, although I'm not sure we want the Fedora infra doc to be under the CPE umbrella as Infra is (and should be) more than just CPE.
Pierre
On Tue, 6 Aug 2019 at 10:19, Pierre-Yves Chibon pingou@pingoured.fr wrote:
On Mon, Aug 05, 2019 at 12:40:53PM +0200, Clement Verna wrote:
On Mon, 5 Aug 2019 at 11:28, Timothée Floure timothee.floure@posteo.net wrote:
Hi,
I wrote [1] to devel some time ago regarding the deprecation of the apps.fp.o index and plan to move its content to the main docs. Kevin mentionned that it could end up in the infrastructure docs and that the whole should be moved to docs.fp.o at some point. I will take a look at both since I have wanted to play with the new documentation pipeline for a while. I am not the best guy to meddle with the infrastructure doc but I might as well do something useful while playing with antora. Tell me if it's not or if I missed something.
Hi thanks for looking at this, We have started a CPE ( Community Platform Engineering) docs [0] with a bit of what this teams does and some of the process around ( this is not live yet)
It actually is live as of last Friday, although I'm not sure we want the Fedora infra doc to be under the CPE umbrella as Infra is (and should be) more than just CPE.
Cool :-), yes although in the CPE docs we have already a list of the applications for the SLEs so maybe this can be consolidated ?
Pierre _______________________________________________ infrastructure mailing list -- infrastructure@lists.fedoraproject.org To unsubscribe send an email to infrastructure-leave@lists.fedoraproject.org Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/infrastructure@lists.fedorapro...
Hi,
Cool :-), yes although in the CPE docs we have already a list of the applications for the SLEs so maybe this can be consolidated ?
My view on the application index is an accessible (= not technical) list of the services we offer our community, not a memo for the infrastructure team. I don't think this use case would fit the SLE page ;-)
The CPE doc explicitly describes the work of a Red Hat team (even if the team powers Fedora's infrastructure) and as such I would instinctively put or link it under the 'general Fedora Infras doc'. The application index could be a top-level page of the infra doc, being part of its general description. Does it makes sense?
On Mon, 5 Aug 2019 at 05:19, Timothée Floure timothee.floure@posteo.net wrote:
Hi,
I wrote [1] to devel some time ago regarding the deprecation of the apps.fp.o index and plan to move its content to the main docs. Kevin mentionned that it could end up in the infrastructure docs and that the whole should be moved to docs.fp.o at some point. I will take a look at both since I have wanted to play with the new documentation pipeline for a while. I am not the best guy to meddle with the infrastructure doc but I might as well do something useful while playing with antora. Tell me if it's not or if I missed something.
The fact that you are wanting to play with it makes you the best person to do this. It may fall down and break a couple of times but have fun doing so. Thank you so much for your work here.
I might have something to show you at Flock if I have troubles sleeping in the train.
[1] https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/...
See you in Budapest,
-- Timothée _______________________________________________ infrastructure mailing list -- infrastructure@lists.fedoraproject.org To unsubscribe send an email to infrastructure-leave@lists.fedoraproject.org Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/infrastructure@lists.fedorapro...
On 8/5/19 1:24 AM, Timothée Floure wrote:
Hi,
I wrote [1] to devel some time ago regarding the deprecation of the apps.fp.o index and plan to move its content to the main docs. Kevin mentionned that it could end up in the infrastructure docs and that the whole should be moved to docs.fp.o at some point. I will take a look at both since I have wanted to play with the new documentation pipeline for a while. I am not the best guy to meddle with the infrastructure doc but I might as well do something useful while playing with antora. Tell me if it's not or if I missed something.
I might have something to show you at Flock if I have troubles sleeping in the train.
[1] https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/...
See you in Budapest,
Thanks again for this. Sorry I didn't meet up with you on it at flock. :(
Anyhow, do let us know when there's something to review or if you need help with it any. :)
Thanks again for working on it.
kevin
On Thu, Aug 15, 2019 at 11:31:06AM -0700, Kevin Fenzi wrote:
On 8/5/19 1:24 AM, Timothée Floure wrote:
Hi,
I wrote [1] to devel some time ago regarding the deprecation of the apps.fp.o index and plan to move its content to the main docs. Kevin mentionned that it could end up in the infrastructure docs and that the whole should be moved to docs.fp.o at some point. I will take a look at both since I have wanted to play with the new documentation pipeline for a while. I am not the best guy to meddle with the infrastructure doc but I might as well do something useful while playing with antora. Tell me if it's not or if I missed something.
I might have something to show you at Flock if I have troubles sleeping in the train.
[1] https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/...
See you in Budapest,
Thanks again for this. Sorry I didn't meet up with you on it at flock. :(
I was so lucky :)
The outcome of our discussion was that we would port the content of this page into an user-oriented Fedora-Infra docs to be included in docs.fp.o. This may be an opportunity for us to move some of our docs from the wiki to docs.fp.o, such as the join page as well as some of the content that is in the infra-docs repo and is in fact more user/contributor oriented.
Thinking about this, I thought that this may be a good place to give the SLE details from a Fedora Infra point of view while we can keep the SLE details from a CPE point of view in the CPE docs (as an example, greenwave and waiverdb are both crucial to Fedora, but CPE doesn't maintain them, so at most all we can do is restart them and potentially submit a patch if we can figure out the issue).
Best, Pierre
The outcome of our discussion was that we would port the content of this page into an user-oriented Fedora-Infra docs to be included in docs.fp.o. This may be an opportunity for us to move some of our docs from the wiki to docs.fp.o, such as the join page as well as some of the content that is in the infra-docs repo and is in fact more user/contributor oriented.
I will ask (within one or two days) someone from mindshare/docs [1] to create an infrastructure repository under the fedora-docs groups [2]. Is there a pagure group for infrastructure members to add to the project?
[1] on https://pagure.io/fedora-docs/issues; the documentation guide literally says to 'ask someone' ... [2] https://pagure.io/group/fedora-docs
There is now an initialized antora project on [1]. I will submit a pull request with the updated application index soon™.
https://pagure.io/infra-docs-fpo/pull-request/1
^ Can someone take a quick look a the changes?
On Mon, 28 Oct 2019 at 08:22, Timothée Floure timothee.floure@posteo.net wrote:
https://pagure.io/infra-docs-fpo/pull-request/1
^ Can someone take a quick look a the changes?
Thanks for doing that, I have added a few comments/questions on the PR :-)
infrastructure mailing list -- infrastructure@lists.fedoraproject.org To unsubscribe send an email to infrastructure-leave@lists.fedoraproject.org Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/infrastructure@lists.fedorapro...
Hi,
https://pagure.io/infra-docs-fpo/pull-request/1 has been merged, which means we can wire it to apps.fp.o, although it's not something I can do myself.
Thanks,
infrastructure@lists.fedoraproject.org