Fedora developer portal - proof of concept

[Petr Hracek]

Hi Fedora devels and other folks,

Adam Samalik and me we create a first proof of concept Fedora Developer 
Portal.
Testing instance is already available here [1].
*
**Fedora Developer Portal* is a new place for developers and not only 
for them, providing information about tools, projects, technologies
and other features that are packaged in Fedora.

This page would be mainly used for developers building on Fedora and 
help them with tools.
But of course other users can use main technologies developed on Fedora.
It is plan to have reference to this portal from [2].

What is possible structure of Fedora Developer Portal is on [3] page 
under section *'Structure'.

*If anyone is interested with helping us to create this portal please 
clone repository [4]
and provide any contents.
We will review it together with other colleagues and add it to this Page.

UX design is going to be discussed and reviewed by Mairin. Thanks for 
your help.

Some discussion about this portal is on Env&Stack mailing list.

What Fedora developer portal should cover at all is here [3] and can be 
extended of course.
GitHub repository for content is [4].
GitHub repository for website is [5].

Feel free to send us any comment or improvements. We would like to 
improve Fedora for developers.
Just contents are missing.

[1] https://developer-phracek.rhcloud.com/
[2] https://getfedora.org/
[3] https://fedoraproject.org/wiki/Websites/Developer
[4] https://github.com/developer-portal/content
[5] https://github.com/developer-portal/website

-- 
Petr Hracek
Software Engineer
Developer Experience
Red Hat, Inc
Mob: [phone]
email: phracek(a)redhat.com

[Josh Boyer]

On Tue, Jul 21, 2015 at 9:45 AM, Petr Hracek <phracek(a)redhat.com&gt; wrote:
>  Hi Fedora devels and other folks,
>
>  Adam Samalik and me we create a first proof of concept Fedora Developer
>  Portal.
>  Testing instance is already available here [1].
>
>  Fedora Developer Portal is a new place for developers and not only for them,
>  providing information about tools, projects, technologies
>  and other features that are packaged in Fedora.
>
>  This page would be mainly used for developers building on Fedora and help
>  them with tools.
>  But of course other users can use main technologies developed on Fedora.
>  It is plan to have reference to this portal from [2].
>
>  What is possible structure of Fedora Developer Portal is on [3] page under
>  section 'Structure'.
>
>  If anyone is interested with helping us to create this portal please clone
>  repository [4]
>  and provide any contents.
>  We will review it together with other colleagues and add it to this Page.
>
>  UX design is going to be discussed and reviewed by Mairin. Thanks for your
>  help. 
I'm curious how this is going to be tied into the Fedora Hubs work?
If it isn't, I'm curious why not :)

josh

[Máirín Duffy]

On 07/21/2015 09:51 AM, Josh Boyer wrote:
>  I'm curious how this is going to be tied into the Fedora Hubs
> work?
>  If it isn't, I'm curious why not :) 
So Fedora Hubs' main audiences are folks who are contributing to Fedora, 
whether they are new or experienced Fedora contributors.

It's my understanding that the developer.fpo site is more focused towards:

- developers who may develop apps for Linux but do not exclusively focus 
on Fedora in terms of as a target for their own applications

- developers who may want to or do use Fedora, and while they happen to 
be developers but don't actually develop Fedora itself.

That being said, there is no reason why we couldn't have a hub tied to 
developer.fpo that aggregates info from developer.fpo and provides a 
social space for Fedora contributors who also fit into the developer.fpo 
audience.

Hope that makes sense?

~m

[Josh Boyer]

On Tue, Jul 21, 2015 at 10:03 AM, Máirín Duffy <duffy(a)redhat.com&gt; wrote:
>  On 07/21/2015 09:51 AM, Josh Boyer wrote:
> >
> > I'm curious how this is going to be tied into the Fedora Hubs work?
> > If it isn't, I'm curious why not :)
>
>
>  So Fedora Hubs' main audiences are folks who are contributing to Fedora,
>  whether they are new or experienced Fedora contributors.
>
>  It's my understanding that the developer.fpo site is more focused towards:
>
>  - developers who may develop apps for Linux but do not exclusively focus on
>  Fedora in terms of as a target for their own applications
>
>  - developers who may want to or do use Fedora, and while they happen to be
>  developers but don't actually develop Fedora itself.
>
>  That being said, there is no reason why we couldn't have a hub tied to
>  developer.fpo that aggregates info from developer.fpo and provides a social
>  space for Fedora contributors who also fit into the developer.fpo audience.
>
>  Hope that makes sense? 
Yes, thank you.

josh

[Adam Samalik]

Thank you all for the feedback!

The site is just a prototype to see how the technology works and to be able to preview the
content in a better way than reading markdown from the git repo.

"Fedora is made for developers" - To be honest, I wasn't trying to write
something great, I just added a line of text to fill the space up. The homepage itself is
very far away from the final state. The main purpose [of the currently deployed version]
of this prototype is to be able to preview the content from git.

"There is no C and C++" - Sory guys, again, the homepage is just filled up with
random stuff. C and C++ will be definitely a part of the content! I promise I will use
Lorem Ipsum more often to avoid these unpleasant situations :-)

Thanks again for the feedback! Any ideas and more feedback is very very welcome! Please
feel free to get engaged in any way. Git repos and the project wiki are mentioned in
Petr's first email. Everything on the current prototype might be (and probably will
be) changed according to your feedback.

Adam

----- Original Message -----
From: "Josh Boyer" <jwboyer(a)fedoraproject.org&gt;
To: "Máirín Duffy" <duffy(a)redhat.com&gt;
Cc: "Development discussions related to Fedora"
<devel(a)lists.fedoraproject.org&gt;, "Fedora Environment and Stacks Working Group
mailing list" <env-and-stacks(a)lists.fedoraproject.org&gt;
Sent: Tuesday, 21 July, 2015 4:05:03 PM
Subject: Re: Fedora developer portal - proof of concept

On Tue, Jul 21, 2015 at 10:03 AM, Máirín Duffy <duffy(a)redhat.com&gt; wrote:
>  On 07/21/2015 09:51 AM, Josh Boyer wrote:
> >
> > I'm curious how this is going to be tied into the Fedora Hubs work?
> > If it isn't, I'm curious why not :)
>
>
>  So Fedora Hubs' main audiences are folks who are contributing to Fedora,
>  whether they are new or experienced Fedora contributors.
>
>  It's my understanding that the developer.fpo site is more focused towards:
>
>  - developers who may develop apps for Linux but do not exclusively focus on
>  Fedora in terms of as a target for their own applications
>
>  - developers who may want to or do use Fedora, and while they happen to be
>  developers but don't actually develop Fedora itself.
>
>  That being said, there is no reason why we couldn't have a hub tied to
>  developer.fpo that aggregates info from developer.fpo and provides a social
>  space for Fedora contributors who also fit into the developer.fpo audience.
>
>  Hope that makes sense? 
Yes, thank you.

josh
-- 
devel mailing list
devel(a)lists.fedoraproject.org
https://admin.fedoraproject.org/mailman/listinfo/devel
Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct

[Máirín Duffy]

On 07/21/2015 10:48 AM, Adam Samalik wrote:
>  "There is no C and C++" - Sory guys, again, the homepage is
> just filled up with random stuff. C and C++ will be definitely a part of the content! I
> promise I will use Lorem Ipsum more often to avoid these unpleasant situations :-) 
I don't know if this content is similarly random then, but with the 
aforementioned target audiences in mind, I'm not sure what's up with the 
Fedora.next section (far right on the nav bar) and the content under 
that. I'm not sure of the context in which the target audience devs 
would need this info?

Another suggestion - I think the language-specific documentation was a 
core and valuable feature in the proposal but it's a bit hidden in this 
design. Under the runtimes/frameworks section on the front, maybe add a 
button for each one "More info for $LANG/FRAMEWORK developers" that 
would drive users to those lang/framework-specific pages (similar to how 
you did 'learn more' for the tools.) Having these accessible only from a 
drop-down menu obscures them a lot unfortunately.

I think the main thing the site is missing is a narrative for how/why 
you'd want to use it. I know you don't have final content, but I think 
users are really going to need more guidance to understand how/why 
they're going to use the site. I think a good next step is developing 
that narrative.

You might also get more helpful / useful feedback by reposting part of 
the proposal on the wiki here on list so folks can get more of an idea 
of the background / context around the site. It was in your footnotes 
but not everybody reads all of those :)

~m

[Máirín Duffy]

(resending with my fpo email; my rht email isn't sub'ed to devel@)

On 07/21/2015 09:51 AM, Josh Boyer wrote:
>  I'm curious how this is going to be tied into the Fedora Hubs
> work?
>  If it isn't, I'm curious why not :) 
So Fedora Hubs' main audiences are folks who are contributing to Fedora, 
whether they are new or experienced Fedora contributors.

It's my understanding that the developer.fpo site is more focused towards:

- developers who may develop apps for Linux but do not exclusively focus 
on Fedora in terms of as a target for their own applications

- developers who may want to or do use Fedora, and while they happen to 
be developers but don't actually develop Fedora itself.

That being said, there is no reason why we couldn't have a hub tied to 
developer.fpo that aggregates info from developer.fpo and provides a 
social space for Fedora contributors who also fit into the developer.fpo 
audience.

Hope that makes sense?

~m

[Jonathan Wakely]

On 21/07/15 15:45 +0200, Petr Hracek wrote:
> Feel free to send us any comment or improvements. We would like to 
> improve Fedora for developers.
> Just contents are missing. 
Under "The latest stable runtimes and frameworks Packaged in Fedora
and ready to use!" would it be worth mentioning C and C++?

GCC 5 is the first compiler to default to the latest C11 standard, and 
we ship more of the latest C++ standard library extensions than any
other compiler.

There's a lot happening in that space, and not everyone gets excited
by shiny dynamic languages ;-)

[Neal Gompa]

On Tue, Jul 21, 2015 at 9:57 AM, Jonathan Wakely <jwakely(a)redhat.com&gt; wrote:

>  On 21/07/15 15:45 +0200, Petr Hracek wrote:
>
> > Feel free to send us any comment or improvements. We would like to
> > improve Fedora for developers.
> > Just contents are missing.
> >
>
>  Under "The latest stable runtimes and frameworks Packaged in Fedora
>  and ready to use!" would it be worth mentioning C and C++?
>
>  GCC 5 is the first compiler to default to the latest C11 standard, and we
>  ship more of the latest C++ standard library extensions than any
>  other compiler.
>
>  There's a lot happening in that space, and not everyone gets excited
>  by shiny dynamic languages ;-)
>
>  --
>  devel mailing list
>  devel(a)lists.fedoraproject.org
>  https://admin.fedoraproject.org/mailman/listinfo/devel
>  Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct 

​Personally, I'm a little uncomfortable with the phrasing "Fedora is made
for developers". It implies that we don't do anything to make it great for
non-developers, which is not true at all. ​Is there a better way we can
word this?


-- 
真実はいつも一つ！/ Always, there's only one truth!

[Josh Boyer]

On Tue, Jul 21, 2015 at 10:00 AM, Neal Gompa <ngompa13(a)gmail.com&gt; wrote:
>  On Tue, Jul 21, 2015 at 9:57 AM, Jonathan Wakely
> <jwakely(a)redhat.com&gt; wrote:
> >
> > On 21/07/15 15:45 +0200, Petr Hracek wrote:
> >>
> >> Feel free to send us any comment or improvements. We would like to
> >> improve Fedora for developers.
> >> Just contents are missing.
> >
> >
> > Under "The latest stable runtimes and frameworks Packaged in Fedora
> > and ready to use!" would it be worth mentioning C and C++?
> >
> > GCC 5 is the first compiler to default to the latest C11 standard, and we
> > ship more of the latest C++ standard library extensions than any
> > other compiler.
> >
> > There's a lot happening in that space, and not everyone gets excited
> > by shiny dynamic languages ;-)
> >
> > --
> > devel mailing list
> > devel(a)lists.fedoraproject.org
> > https://admin.fedoraproject.org/mailman/listinfo/devel
> > Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
>
>
>  Personally, I'm a little uncomfortable with the phrasing "Fedora is made for
>  developers". It implies that we don't do anything to make it great for
>  non-developers, which is not true at all. Is there a better way we can word
>  this? 
The site is specifically targeted at developers.  The URL will likely
be something like developers.fedoraproject.org.  This isn't a generic,
front-page site.  Given the targeted nature of it, I think it's
perfectly fine to say Fedora is built for developers.  I mean, you
wouldn't want a developer coming to this page and seeing "Fedora is
built for everyone" and then a bunch of text explaining that.

josh