New Fedora Developer Portal release

[Pavel Valena]

Hello,

long overdue release has landed to: https://developer.fedoraproject.org/

Please check the updated website!

Most notable changes (in no particular order):

 - Removed search, due to plugin incompatability [1].
 - Updated Ruby install page [2].
 - Nodejs page update [3].
 - New Web Application page [4].
 - Almost all Python pages updated [5].
 - Docker pages updated [6].

Detailed info is available on our ML [*].

Any feedback is welcome!

[1] https://github.com/developer-portal/website/pull/104
[2] https://developer.fedoraproject.org/tech/languages/ruby/ruby-installation...
[3] https://developer.fedoraproject.org/tech/languages/nodejs/nodejs.html
[4] https://developer.fedoraproject.org/start/sw/web-app/about.html
[5] https://developer.fedoraproject.org/tech/languages/python/multiple-python...
[6] https://developer.fedoraproject.org/tools/docker/docker-installation.html
[*]
https://lists.fedoraproject.org/archives/list/[e-mail]...

Regards,
-- 
Pavel Valena
Software Engineer, Red Hat
Brno, Czech Republic

[Neal Gompa]

On Mon, Apr 12, 2021 at 8:08 PM Pavel Valena <pvalena(a)redhat.com&gt; wrote:
>  Hello,
>
>  long overdue release has landed to: https://developer.fedoraproject.org/
>
>  Please check the updated website!
>
>  Most notable changes (in no particular order):
>
>   - Removed search, due to plugin incompatability [1].
>   - Updated Ruby install page [2].
>   - Nodejs page update [3].
>   - New Web Application page [4].
>   - Almost all Python pages updated [5].
>   - Docker pages updated [6].
>
>  Detailed info is available on our ML [*].
>
>  Any feedback is welcome! 
Thanks for the major refresh of the content on the developer portal!

That said, I have a small fix on the Docker page:
https://github.com/developer-portal/content/pull/371



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

[Matthew Miller]

On Mon, Apr 12, 2021 at 08:08:29PM -0400, Pavel Valena wrote:
>  long overdue release has landed to:
> https://developer.fedoraproject.org/
>  Please check the updated website! 
Nice!

>  Detailed info is available on our ML [*]. 
I admit I didn't even know there was a mailing list! Would it be worth
discussing merging that list with the regular docs mailing list?

>  Any feedback is welcome! 
Even if we want to leave DevAssistant pages for history, the link on 
https://developer.fedoraproject.org/tools.html should probably go.

On the other side of things, it'd be nice to add one for Toolbox.

-- 
Matthew Miller
<mattdm(a)fedoraproject.org&gt;
Fedora Project Leader

[Pavel Valena]

----- Original Message -----
>  From: "Matthew Miller" <mattdm(a)fedoraproject.org&gt;
>  To: "Development discussions related to Fedora"
> <devel(a)lists.fedoraproject.org&gt;
>  Cc: developer-portal(a)lists.fedoraproject.org
>  Sent: Tuesday, April 13, 2021 9:01:40 PM
>  Subject: Re: New Fedora Developer Portal release
>  
>  On Mon, Apr 12, 2021 at 08:08:29PM -0400, Pavel Valena wrote:
>  > long overdue release has landed to: https://developer.fedoraproject.org/
>  > Please check the updated website!
>  
>  Nice! 
Thanks!

>  
>  > Detailed info is available on our ML [*].
>  
>  I admit I didn't even know there was a mailing list! Would it be worth
>  discussing merging that list with the regular docs mailing list? 
Well, it's ok, almost noone knows :) ... It's a secret... joking, it simply does
not get much traffic (statistics, and pre-release info mostly). All conversations are on
github.com/developer-portal instead.

Merging does not seem like a good idea to me. I can post in CC everything I write into
docs list if you want me to (but I don't, and won't read it!). I wouldn't like
replacing it, as, strictly speaking, we don't do docs on Developer Portal!

   https://developer-portal.github.io/contributing/write-introduction.html

It's more aimed at existing developers who need a quick-start, simply "install
this and that", and it doesn't even have to be in Fedora (f.e. build it from
sources, or install from COPR), but the aim is instead on running it ON Fedora. I like to
think of it like from developers, to developers [on Fedora]. Just a few must-read lines
you need to get you started (or discover) the tool/tech/language... F.e. some content
didn't even make it in, simply because it was too long (docs-like).

  https://fedoraproject.org/wiki/Websites/Developer#Target_Audience

I hope this clears it up, at least a bit.

>  
>  > Any feedback is welcome!
>  
>  Even if we want to leave DevAssistant pages for history, the link on
>  https://developer.fedoraproject.org/tools.html should probably go. 
You're right, thanks for a catch! I'm thinking of removing the content altogether
though. Is anyone against?

>  
>  On the other side of things, it'd be nice to add one for Toolbox. 
Feel free to drop in an issue here:
https://github.com/developer-portal/content/issues/new

>  
>  --
>  Matthew Miller
>  <mattdm(a)fedoraproject.org&gt;
>  Fedora Project Leader 
Regards,
-- 
Pavel Valena
Software Engineer, Red Hat
Brno, Czech Republic

[Gleb Vassiljev]

Hello!

I agree that keeping it separate is better. 
However there should be more links from docs site to developer-portal where appropriate.
For some languages and tools there is no mention at all, for example last time I tried
Scala and some tooling weren't that obvious to me (I wish I had documented it). Anyway
what I like to say is that it needs more exposure so that people who know different
languages would contribute. I would suggest writing an article on Fedora magazine that
more contributors are welcome and maybe list some of the big languages that need entries.
It can be a bit hard to balance keeping the information unopinionated and general enough
to be useful. 

kind regards
Gleb

[Pavel Valena]

----- Original Message -----
>  From: "Gleb Vassiljev" <gleb(a)netkom.se&gt;
>  To: developer-portal(a)lists.fedoraproject.org
>  Sent: Thursday, April 15, 2021 2:08:28 AM
>  Subject: [Developer-portal] Re: New Fedora Developer Portal release
>  
>  Hello! 
Hi.

>  
>  I agree that keeping it separate is better.
>  However there should be more links from docs site to developer-portal where
>  appropriate. For some languages and tools there is no mention at all, for
>  example last time I tried Scala and some tooling weren't that obvious to me
>  (I wish I had documented it). Anyway what I like to say is that it needs
>  more exposure so that people who know different languages would contribute. 
Yes, you're right :). Is that something you'd be interested in helping with?
There's only a very limited amount of cycles I can spend on Developer Portal.

>  I would suggest writing an article on Fedora magazine that more
> contributors
>  are welcome and maybe list some of the big languages that need entries. It 
Not sure if this is a good candidate for Magazine (do Developers read it?), but I think
it's a good idea to send the requests it to various ML - devel and SIGs.

>  can be a bit hard to balance keeping the information unopinionated
> and
>  general enough to be useful. 
That's when the Pull Request Reviews come into picture. I'd advise everyone
interested in Developer Portal content to simply watch the content repo :).

>  
>  kind regards
>  Gleb 
Regards,
-- 
Pavel Valena
Software Engineer, Red Hat
Brno, Czech Republic