Re: [Developer-portal] Re: Updating fedora wiki
----- Original Message -----
From: "Brian Exelbierd" <bex(a)pobox.com>
To: docs(a)lists.fedoraproject.org, developer-portal(a)lists.fedoraproject.org
Sent: Monday, July 24, 2017 11:18:21 AM
Subject: [Developer-portal] Re: Updating fedora wiki
+developer-portal(a)lists.fedoraproject.org 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
> > _______________________________________________