Re: Updating fedora wiki

[Brian Exelbierd]

[e-mail] s this is not a docs
maintained resource.

On Fri, Jul 21, 2017, at 11:31 PM, Paul W. Frields wrote:
> On Fri, Jul 21, 2017 at 04:45:56PM +0200, Brian Exelbierd wrote:
> > On Fri, Jul 21, 2017, at 03:10 AM, Ben Kelsey wrote:
> > > Hi, 
> > > I was trying to update a page at https://fedoraproject.org/wiki/HOWTO_Setup_Android_Development and it says I need to be added to a group to do this. Can someone add me to the required group. My user name is bkelsey.
> >
> > Hi Ben,
> >
> > I think the page would be way more useful if it was on this site:
> >
> > https://developer.fedoraproject.org/start.html
> >
> > Would you be be interested in porting it over?
>
> I agree with bex... OTOH be warned that the developer.fp.o site isn't
> quite as straightforward as to how you craft pages for it.  I just
> went through that gauntlet to create:
> https://github.com/developer-portal/content/pull/203
>
> Not impossible by any means -- just more complex than its own docs
> indicate on how to make changes.  (Mumble mumble, something about the
> cobbler's kids' shoes.) ;-)
>
> -- 
> Paul W. Frields                                http://paul.frields.org/
>   gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
>   http://redhat.com/   -  -  -  -   http://pfrields.fedorapeople.org/
>     The open source story continues to grow: http://opensource.com
> _______________________________________________
> docs mailing list -- [e-mail]
> To unsubscribe send an email to [e-mail]

Updating fedora wiki

[Pavel Valena]

----- Original Message -----
> From: "Brian Exelbierd" 
> To: [e-mail], [e-mail]
> Sent: Monday, July 24, 2017 11:18:21 AM
> Subject: [Developer-portal] Re: Updating fedora wiki
>
> [e-mail] s this is not a docs
> maintained resource.
>
> On Fri, Jul 21, 2017, at 11:31 PM, Paul W. Frields wrote:
> > On Fri, Jul 21, 2017 at 04:45:56PM +0200, Brian Exelbierd wrote:
> > > On Fri, Jul 21, 2017, at 03:10 AM, Ben Kelsey wrote:
> > > > Hi,
> > > > I was trying to update a page at
> > > > https://fedoraproject.org/wiki/HOWTO_Setup_Android_Development and it
> > > > says I need to be added to a group to do this. Can someone add me to
> > > > the required group. My user name is bkelsey.
> > >
> > > Hi Ben,
> > >
> > > I think the page would be way more useful if it was on this site:
> > >
> > > https://developer.fedoraproject.org/start.html

Thank you Bex.

Yes, that seems to be the type of content we're looking for.
> > > Would you be be interested in porting it over?
> >
> > I agree with bex... OTOH be warned that the developer.fp.o site isn't
> > quite as straightforward as to how you craft pages for it.  I just
> > went through that gauntlet to create:
> > https://github.com/developer-portal/content/pull/203

True. It can be challenging for some people. That's partly because the guides (and docs) are missing or outdated. Sadly, there are no people to fix that (sorry). Any help is greatly appreciated.

On the other hand, we expect the developers themselves to create and maintain the Developer Portal content, so some level of experience (with git, Markdown, etc.) is expected. Alternatively you can gain the experience in the process, as we'll gladly help you with the PRs.
> > Not impossible by any means -- just more complex than its own docs
> > indicate on how to make changes.  (Mumble mumble, something about the
> > cobbler's kids' shoes.) ;-)

From my POV updating already existing content is quite easy. Please let me know what you consider complex in doing so, because we really need to make it simple and straightforward.

Adding a completely new content can be hard, because (as of now) you need to build and view the website locally, and that is not fully automated yet. There are some help scripts, READMEs, and tools in our repositories[1][2] though (that's missing in the contributing guide too :/) and we're on irc (#developer-portal @Freenode) if you run into some obstacles.

Note that the PR above adds a content, that IMHO is documentation-like, which is a NO-GO for Developer Portal, so that needs to be fixed too (not to mention the Markdown there needs quite a bit of polishing, which I do not consider complex at all).

Regards,
Pavel

[1] https://github.com/developer-portal/website/
[2] https://github.com/developer-portal/tools/
> > --
> > Paul W. Frields                                http://paul.frields.org/
> >   gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
> >   http://redhat.com/   -  -  -  -   http://pfrields.fedorapeople.org/
> >     The open source story continues to grow: http://opensource.com
> > _______________________________________________