Move our guides do docs.fp.o?

[Adam Samalik]

What if we moved our guides to docs.fp.o?

I wanted to document the way we could use the Taiga board, but I'm not sure
where to put it.

So far, I've found:
* Fedora Magazine (wiki) - https://fedoraproject.org/wiki/Magazine
* Writing a new pitch (Wordpress) -
https://fedoramagazine.org/writing-a-new-pitch/
* Writing an article (Wordpress) -
https://fedoramagazine.org/writing-an-article-for-the-fedora-magazine/
* Writing an article (wiki) -
https://fedoraproject.org/wiki/Magazine/Howtopost
* Creating a featured image (Wordpress) -
https://fedoramagazine.org/creating-a-featured-image-for-a-fedora-magazin...
* Editorial meetings (wiki) -
https://fedoraproject.org/wiki/Magazine/Editorial_meetings

Moving to the docs would give us one place with a menu on the left for
easier navigation. And that could be potentially helpful to any new
contributors.

If we want to do this, I volunteer to set it up and move everything there.
We'd need to have a repository with a structure similar to the docs
template [1], which would produce something similar to the CommOps docs [2].

What do people think?

Cheers,
Adam


[1] https://pagure.io/fedora-docs/template
[2] https://docs.fedoraproject.org/en-US/commops/

-- 

Adam Šamalík
---------------------------
Senior Software Engineer
Red Hat

On Mon, 2019-06-03 at 16:15 +0200, Adam Samalik wrote:
>  What if we moved our guides to docs.fp.o? 
It would make sense
from the POV of the user I would think. Would there
be any caveats or drawbacks to be aware of?

Stephen

>  
>  I wanted to document the way we could use the Taiga board, but I'm
>  not sure
>  where to put it.
>  
>  So far, I've found:
>  * Fedora Magazine (wiki) - https://fedoraproject.org/wiki/Magazine
>  * Writing a new pitch (Wordpress) -
>  https://fedoramagazine.org/writing-a-new-pitch/
>  * Writing an article (Wordpress) -
>  https://fedoramagazine.org/writing-an-article-for-the-fedora-magazine/
>  * Writing an article (wiki) -
>  https://fedoraproject.org/wiki/Magazine/Howtopost
>  * Creating a featured image (Wordpress) -
>  https://fedoramagazine.org/creating-a-featured-image-for-a-fedora-magazin...
>  * Editorial meetings (wiki) -
>  https://fedoraproject.org/wiki/Magazine/Editorial_meetings
>  
>  Moving to the docs would give us one place with a menu on the left
>  for
>  easier navigation. And that could be potentially helpful to any new
>  contributors.
>  
>  If we want to do this, I volunteer to set it up and move everything
>  there.
>  We'd need to have a repository with a structure similar to the docs
>  template [1], which would produce something similar to the CommOps
>  docs [2].
>  
>  What do people think?
>  
>  Cheers,
>  Adam
>  
>  
>  [1] https://pagure.io/fedora-docs/template
>  [2] https://docs.fedoraproject.org/en-US/commops/
>  
>  -- 
>  
>  Adam Šamalík
>  ---------------------------
>  Senior Software Engineer
>  Red Hat
>  _______________________________________________
>  Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
>  To unsubscribe send an email to 
>  magazine-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/[e-mail]...

[Adam Samalik]

On Mon, Jun 3, 2019 at 4:51 PM <s40w5s(a)gmail.com&gt; wrote:

>  On Mon, 2019-06-03 at 16:15 +0200, Adam Samalik wrote:
>  > What if we moved our guides to docs.fp.o?
>  It would make sense from the POV of the user I would think. Would there
>  be any caveats or drawbacks to be aware of?
>  
The only one I can think of would be approximately an hour delay between
the time we edit something and the time it shows up on the site. Other than
that I'm not aware of any.



>  Stephen
>
>  >
>  > I wanted to document the way we could use the Taiga board, but I'm
>  > not sure
>  > where to put it.
>  >
>  > So far, I've found:
>  > * Fedora Magazine (wiki) - https://fedoraproject.org/wiki/Magazine
>  > * Writing a new pitch (Wordpress) -
>  > https://fedoramagazine.org/writing-a-new-pitch/
>  > * Writing an article (Wordpress) -
>  > https://fedoramagazine.org/writing-an-article-for-the-fedora-magazine/
>  > * Writing an article (wiki) -
>  > https://fedoraproject.org/wiki/Magazine/Howtopost
>  > * Creating a featured image (Wordpress) -
>  >
>  https://fedoramagazine.org/creating-a-featured-image-for-a-fedora-magazin...
>  > * Editorial meetings (wiki) -
>  > https://fedoraproject.org/wiki/Magazine/Editorial_meetings
>  >
>  > Moving to the docs would give us one place with a menu on the left
>  > for
>  > easier navigation. And that could be potentially helpful to any new
>  > contributors.
>  >
>  > If we want to do this, I volunteer to set it up and move everything
>  > there.
>  > We'd need to have a repository with a structure similar to the docs
>  > template [1], which would produce something similar to the CommOps
>  > docs [2].
>  >
>  > What do people think?
>  >
>  > Cheers,
>  > Adam
>  >
>  >
>  > [1] https://pagure.io/fedora-docs/template
>  > [2] https://docs.fedoraproject.org/en-US/commops/
>  >
>  > --
>  >
>  > Adam Šamalík
>  > ---------------------------
>  > Senior Software Engineer
>  > Red Hat
>  > _______________________________________________
>  > Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
>  > To unsubscribe send an email to
>  > magazine-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/[e-mail]...
>
>  
-- 

Adam Šamalík
---------------------------
Senior Software Engineer
Red Hat

[Paul Frields]

It feels to me like the right thing to do. It's more inline with other
project/team docs, and probably more discoverable.

On Mon, Jun 3, 2019 at 11:06 AM Adam Samalik <asamalik(a)redhat.com&gt; wrote:
>
> On Mon, Jun 3, 2019 at 4:51 PM <s40w5s(a)gmail.com&gt; wrote:
>
> > On Mon, 2019-06-03 at 16:15 +0200, Adam Samalik wrote:
> > > What if we moved our guides to docs.fp.o?
> > It would make sense from the POV of the user I would think. Would there
> > be any caveats or drawbacks to be aware of?
> >
>
> The only one I can think of would be approximately an hour delay between
> the time we edit something and the time it shows up on the site. Other than
> that I'm not aware of any.
>
>
>
> >
> > Stephen
> >
> > >
> > > I wanted to document the way we could use the Taiga board, but I'm
> > > not sure
> > > where to put it.
> > >
> > > So far, I've found:
> > > * Fedora Magazine (wiki) - https://fedoraproject.org/wiki/Magazine
> > > * Writing a new pitch (Wordpress) -
> > > https://fedoramagazine.org/writing-a-new-pitch/
> > > * Writing an article (Wordpress) -
> > > https://fedoramagazine.org/writing-an-article-for-the-fedora-magazine/
> > > * Writing an article (wiki) -
> > > https://fedoraproject.org/wiki/Magazine/Howtopost
> > > * Creating a featured image (Wordpress) -
> > >
> >
https://fedoramagazine.org/creating-a-featured-image-for-a-fedora-magazin...
> > > * Editorial meetings (wiki) -
> > > https://fedoraproject.org/wiki/Magazine/Editorial_meetings
> > >
> > > Moving to the docs would give us one place with a menu on the left
> > > for
> > > easier navigation. And that could be potentially helpful to any new
> > > contributors.
> > >
> > > If we want to do this, I volunteer to set it up and move everything
> > > there.
> > > We'd need to have a repository with a structure similar to the docs
> > > template [1], which would produce something similar to the CommOps
> > > docs [2].
> > >
> > > What do people think?
> > >
> > > Cheers,
> > > Adam
> > >
> > >
> > > [1] https://pagure.io/fedora-docs/template
> > > [2] https://docs.fedoraproject.org/en-US/commops/
> > >
> > > --
> > >
> > > Adam Šamalík
> > > ---------------------------
> > > Senior Software Engineer
> > > Red Hat
> > > _______________________________________________
> > > Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
> > > To unsubscribe send an email to
> > > magazine-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/[e-mail]...
> >
> >
>
> --
>
> Adam Šamalík
> ---------------------------
> Senior Software Engineer
> Red Hat
> _______________________________________________
> Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
> To unsubscribe send an email to magazine-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/[e-mail]...

[Adam Samalik]

And there we go: https://docs.fedoraproject.org/en-US/fedora-magazine/

Sources: https://pagure.io/fedora-magazine

I believe I got everything there. I'll wait for a few people to +1 before I
delete the old pages and/or replace them with a redirect.

On Mon, Jun 3, 2019 at 9:05 PM Paul Frields <stickster(a)gmail.com&gt; wrote:

>  It feels to me like the right thing to do. It's more inline with
> other
>  project/team docs, and probably more discoverable.
>
>  On Mon, Jun 3, 2019 at 11:06 AM Adam Samalik <asamalik(a)redhat.com&gt; wrote:
>  >
>  > On Mon, Jun 3, 2019 at 4:51 PM <s40w5s(a)gmail.com&gt; wrote:
>  >
>  > > On Mon, 2019-06-03 at 16:15 +0200, Adam Samalik wrote:
>  > > > What if we moved our guides to docs.fp.o?
>  > > It would make sense from the POV of the user I would think. Would there
>  > > be any caveats or drawbacks to be aware of?
>  > >
>  >
>  > The only one I can think of would be approximately an hour delay between
>  > the time we edit something and the time it shows up on the site. Other
>  than
>  > that I'm not aware of any.
>  >
>  >
>  >
>  > >
>  > > Stephen
>  > >
>  > > >
>  > > > I wanted to document the way we could use the Taiga board, but I'm
>  > > > not sure
>  > > > where to put it.
>  > > >
>  > > > So far, I've found:
>  > > > * Fedora Magazine (wiki) - https://fedoraproject.org/wiki/Magazine
>  > > > * Writing a new pitch (Wordpress) -
>  > > > https://fedoramagazine.org/writing-a-new-pitch/
>  > > > * Writing an article (Wordpress) -
>  > > >
>  https://fedoramagazine.org/writing-an-article-for-the-fedora-magazine/
>  > > > * Writing an article (wiki) -
>  > > > https://fedoraproject.org/wiki/Magazine/Howtopost
>  > > > * Creating a featured image (Wordpress) -
>  > > >
>  > >
>  https://fedoramagazine.org/creating-a-featured-image-for-a-fedora-magazin...
>  > > > * Editorial meetings (wiki) -
>  > > > https://fedoraproject.org/wiki/Magazine/Editorial_meetings
>  > > >
>  > > > Moving to the docs would give us one place with a menu on the left
>  > > > for
>  > > > easier navigation. And that could be potentially helpful to any new
>  > > > contributors.
>  > > >
>  > > > If we want to do this, I volunteer to set it up and move everything
>  > > > there.
>  > > > We'd need to have a repository with a structure similar to the docs
>  > > > template [1], which would produce something similar to the CommOps
>  > > > docs [2].
>  > > >
>  > > > What do people think?
>  > > >
>  > > > Cheers,
>  > > > Adam
>  > > >
>  > > >
>  > > > [1] https://pagure.io/fedora-docs/template
>  > > > [2] https://docs.fedoraproject.org/en-US/commops/
>  > > >
>  > > > --
>  > > >
>  > > > Adam Šamalík
>  > > > ---------------------------
>  > > > Senior Software Engineer
>  > > > Red Hat
>  > > > _______________________________________________
>  > > > Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
>  > > > To unsubscribe send an email to
>  > > > magazine-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/[e-mail]...
>  > >
>  > >
>  >
>  > --
>  >
>  > Adam Šamalík
>  > ---------------------------
>  > Senior Software Engineer
>  > Red Hat
>  > _______________________________________________
>  > Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
>  > To unsubscribe send an email to magazine-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/[e-mail]...
>  

-- 

Adam Šamalík
---------------------------
Senior Software Engineer
Red Hat

[Paul Frields]

I did a bunch of the redirects needed already, so hopefully I saved
you some time. ;-)

On Tue, Jun 4, 2019 at 11:30 AM Adam Samalik <asamalik(a)redhat.com&gt; wrote:
>
> And there we go: https://docs.fedoraproject.org/en-US/fedora-magazine/
>
> Sources: https://pagure.io/fedora-magazine
>
> I believe I got everything there. I'll wait for a few people to +1 before I
delete the old pages and/or replace them with a redirect.
>
> On Mon, Jun 3, 2019 at 9:05 PM Paul Frields <stickster(a)gmail.com&gt; wrote:
>>
>> It feels to me like the right thing to do. It's more inline with other
>> project/team docs, and probably more discoverable.
>>
>> On Mon, Jun 3, 2019 at 11:06 AM Adam Samalik <asamalik(a)redhat.com&gt; wrote:
>> >
>> > On Mon, Jun 3, 2019 at 4:51 PM <s40w5s(a)gmail.com&gt; wrote:
>> >
>> > > On Mon, 2019-06-03 at 16:15 +0200, Adam Samalik wrote:
>> > > > What if we moved our guides to docs.fp.o?
>> > > It would make sense from the POV of the user I would think. Would
there
>> > > be any caveats or drawbacks to be aware of?
>> > >
>> >
>> > The only one I can think of would be approximately an hour delay between
>> > the time we edit something and the time it shows up on the site. Other than
>> > that I'm not aware of any.
>> >
>> >
>> >
>> > >
>> > > Stephen
>> > >
>> > > >
>> > > > I wanted to document the way we could use the Taiga board, but
I'm
>> > > > not sure
>> > > > where to put it.
>> > > >
>> > > > So far, I've found:
>> > > > * Fedora Magazine (wiki) -
https://fedoraproject.org/wiki/Magazine
>> > > > * Writing a new pitch (Wordpress) -
>> > > > https://fedoramagazine.org/writing-a-new-pitch/
>> > > > * Writing an article (Wordpress) -
>> > > >
https://fedoramagazine.org/writing-an-article-for-the-fedora-magazine/
>> > > > * Writing an article (wiki) -
>> > > > https://fedoraproject.org/wiki/Magazine/Howtopost
>> > > > * Creating a featured image (Wordpress) -
>> > > >
>> > >
https://fedoramagazine.org/creating-a-featured-image-for-a-fedora-magazin...
>> > > > * Editorial meetings (wiki) -
>> > > > https://fedoraproject.org/wiki/Magazine/Editorial_meetings
>> > > >
>> > > > Moving to the docs would give us one place with a menu on the
left
>> > > > for
>> > > > easier navigation. And that could be potentially helpful to any
new
>> > > > contributors.
>> > > >
>> > > > If we want to do this, I volunteer to set it up and move
everything
>> > > > there.
>> > > > We'd need to have a repository with a structure similar to the
docs
>> > > > template [1], which would produce something similar to the
CommOps
>> > > > docs [2].
>> > > >
>> > > > What do people think?
>> > > >
>> > > > Cheers,
>> > > > Adam
>> > > >
>> > > >
>> > > > [1] https://pagure.io/fedora-docs/template
>> > > > [2] https://docs.fedoraproject.org/en-US/commops/
>> > > >
>> > > > --
>> > > >
>> > > > Adam Šamalík
>> > > > ---------------------------
>> > > > Senior Software Engineer
>> > > > Red Hat
>> > > > _______________________________________________
>> > > > Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
>> > > > To unsubscribe send an email to
>> > > > magazine-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/[e-mail]...
>> > >
>> > >
>> >
>> > --
>> >
>> > Adam Šamalík
>> > ---------------------------
>> > Senior Software Engineer
>> > Red Hat
>> > _______________________________________________
>> > Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
>> > To unsubscribe send an email to magazine-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/[e-mail]...
>
>
>
> --
>
> Adam Šamalík
> ---------------------------
> Senior Software Engineer
> Red Hat

[Adam Samalik]

I've just redirected all the wiki pages I have mentioned in the
original email.

Paul, were you working on the Wordpress redirects? Something might have
gone wrong, they're only showing 404 but not redirecting. :(

On Thu, Jun 6, 2019 at 11:01 PM Paul Frields <stickster(a)gmail.com&gt; wrote:

>  I did a bunch of the redirects needed already, so hopefully I saved
>  you some time. ;-)
>
>  On Tue, Jun 4, 2019 at 11:30 AM Adam Samalik <asamalik(a)redhat.com&gt; wrote:
>  >
>  > And there we go: https://docs.fedoraproject.org/en-US/fedora-magazine/
>  >
>  > Sources: https://pagure.io/fedora-magazine
>  >
>  > I believe I got everything there. I'll wait for a few people to +1
>  before I delete the old pages and/or replace them with a redirect.
>  >
>  > On Mon, Jun 3, 2019 at 9:05 PM Paul Frields <stickster(a)gmail.com&gt; wrote:
>  >>
>  >> It feels to me like the right thing to do. It's more inline with other
>  >> project/team docs, and probably more discoverable.
>  >>
>  >> On Mon, Jun 3, 2019 at 11:06 AM Adam Samalik <asamalik(a)redhat.com&gt;
>  wrote:
>  >> >
>  >> > On Mon, Jun 3, 2019 at 4:51 PM <s40w5s(a)gmail.com&gt; wrote:
>  >> >
>  >> > > On Mon, 2019-06-03 at 16:15 +0200, Adam Samalik wrote:
>  >> > > > What if we moved our guides to docs.fp.o?
>  >> > > It would make sense from the POV of the user I would think. Would
>  there
>  >> > > be any caveats or drawbacks to be aware of?
>  >> > >
>  >> >
>  >> > The only one I can think of would be approximately an hour delay
>  between
>  >> > the time we edit something and the time it shows up on the site.
>  Other than
>  >> > that I'm not aware of any.
>  >> >
>  >> >
>  >> >
>  >> > >
>  >> > > Stephen
>  >> > >
>  >> > > >
>  >> > > > I wanted to document the way we could use the Taiga board, but
> I'm
>  >> > > > not sure
>  >> > > > where to put it.
>  >> > > >
>  >> > > > So far, I've found:
>  >> > > > * Fedora Magazine (wiki) -
>  https://fedoraproject.org/wiki/Magazine
>  >> > > > * Writing a new pitch (Wordpress) -
>  >> > > > https://fedoramagazine.org/writing-a-new-pitch/
>  >> > > > * Writing an article (Wordpress) -
>  >> > > >
>  https://fedoramagazine.org/writing-an-article-for-the-fedora-magazine/
>  >> > > > * Writing an article (wiki) -
>  >> > > > https://fedoraproject.org/wiki/Magazine/Howtopost
>  >> > > > * Creating a featured image (Wordpress) -
>  >> > > >
>  >> > >
>  https://fedoramagazine.org/creating-a-featured-image-for-a-fedora-magazin...
>  >> > > > * Editorial meetings (wiki) -
>  >> > > > https://fedoraproject.org/wiki/Magazine/Editorial_meetings
>  >> > > >
>  >> > > > Moving to the docs would give us one place with a menu on the
> left
>  >> > > > for
>  >> > > > easier navigation. And that could be potentially helpful to any
>  new
>  >> > > > contributors.
>  >> > > >
>  >> > > > If we want to do this, I volunteer to set it up and move
>  everything
>  >> > > > there.
>  >> > > > We'd need to have a repository with a structure similar to
> the
>  docs
>  >> > > > template [1], which would produce something similar to the
> CommOps
>  >> > > > docs [2].
>  >> > > >
>  >> > > > What do people think?
>  >> > > >
>  >> > > > Cheers,
>  >> > > > Adam
>  >> > > >
>  >> > > >
>  >> > > > [1] https://pagure.io/fedora-docs/template
>  >> > > > [2] https://docs.fedoraproject.org/en-US/commops/
>  >> > > >
>  >> > > > --
>  >> > > >
>  >> > > > Adam Šamalík
>  >> > > > ---------------------------
>  >> > > > Senior Software Engineer
>  >> > > > Red Hat
>  >> > > > _______________________________________________
>  >> > > > Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
>  >> > > > To unsubscribe send an email to
>  >> > > > magazine-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/[e-mail]...
>  >> > >
>  >> > >
>  >> >
>  >> > --
>  >> >
>  >> > Adam Šamalík
>  >> > ---------------------------
>  >> > Senior Software Engineer
>  >> > Red Hat
>  >> > _______________________________________________
>  >> > Fedora Magazine mailing list -- magazine(a)lists.fedoraproject.org
>  >> > To unsubscribe send an email to
>  magazine-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/[e-mail]...
>  >
>  >
>  >
>  > --
>  >
>  > Adam Šamalík
>  > ---------------------------
>  > Senior Software Engineer
>  > Red Hat
>  

-- 

Adam Šamalík
---------------------------
Senior Software Engineer
Red Hat