<html><body><div style="color:#000; background-color:#fff; font-family:Courier New, courier, monaco, monospace, sans-serif;font-size:10px"><div id="yui_3_16_0_1_1432868799633_36874">Pete</div><div id="yui_3_16_0_1_1432868799633_36873" dir="ltr">what about <a id="yui_3_16_0_1_1432868799633_36872" href="http://start.fedoraproject.org/">http://start.fedoraproject.org/</a> <br></div><div id="yui_3_16_0_1_1432868799633_36871" dir="ltr"><br></div><div id="yui_3_16_0_1_1432868799633_36870" dir="ltr">which usually points to <br></div><div id="yui_3_16_0_1_1432868799633_36868" dir="ltr"><br></div><div id="yui_3_16_0_1_1432868799633_36869" dir="ltr"><a id="yui_3_16_0_1_1432868799633_36901" href="http://fedoramagazine.org/5tftw-2015-05-28/">http://fedoramagazine.org/5tftw-2015-05-28/</a></div><div id="yui_3_16_0_1_1432868799633_36918" dir="ltr"><br></div><div id="yui_3_16_0_1_1432868799633_36919" dir="ltr">the magazine. <br></div><div id="yui_3_16_0_1_1432868799633_36920" dir="ltr"><br></div><div id="yui_3_16_0_1_1432868799633_36921" dir="ltr">Would not the magazine be a good place to have a section to meet Adam's great ideas.<br></div><div id="yui_3_16_0_1_1432868799633_36867"><span></span></div><div id="yui_3_16_0_1_1432868799633_36850"> </div><div id="yui_3_16_0_1_1432868799633_36858" class="signature"><div id="yui_3_16_0_1_1432868799633_36857"><div id="yui_3_16_0_1_1432868799633_36856"><div id="yui_3_16_0_1_1432868799633_36855"><div id="yui_3_16_0_1_1432868799633_36854"><div id="yui_3_16_0_1_1432868799633_36853"><div id="yui_3_16_0_1_1432868799633_36852"><div id="yui_3_16_0_1_1432868799633_36851"><span style="" lang="FR-CA">Regards</span> <div id="yui_3_16_0_1_1432868799633_36859"><b><font size="2"><br></font><font size="2"> Leslie</font><br></b></div> <div id="yui_3_16_0_1_1432868799633_36937"><font color="green"><b><font size="1">Mr. Leslie Satenstein</font></b></font><font style="color:rgb(191, 0, 95);" size="1" color="green"><span style="font-weight:bold;"></span></font><br></div><font size="2" color="green"><b>Montréal Québec, Canada</b><br></font><br><font face="lucida console, sans-serif" size="1"><b id="yui_3_13_0_ym1_1_1391351152837_28311"><font id="yui_3_13_0_ym1_1_1391351152837_28310" color="black"><span id="yui_3_13_0_ym1_1_1391351152837_28309" style="font-weight:bold;font-size:13.5pt;color:black;"></span></font></b></font></div></div></div></div></div></div></div></div><br> <blockquote id="yui_3_16_0_1_1432868799633_36943" style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; margin-top: 5px; padding-left: 5px;"> <div id="yui_3_16_0_1_1432868799633_36942" style="font-family: Courier New, courier, monaco, monospace, sans-serif; font-size: 10px;"> <div id="yui_3_16_0_1_1432868799633_36941" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div id="yui_3_16_0_1_1432868799633_36940" dir="ltr"> <hr size="1"> <font face="Arial" size="2"> <b><span style="font-weight:bold;">From:</span></b> Pete Travis <lists@petetravis.com><br> <b><span style="font-weight: bold;">To:</span></b> Adam Samalik <asamalik@redhat.com>; websites@lists.fedoraproject.org <br><b><span style="font-weight: bold;">Cc:</span></b> For participants of the Documentation Project <docs@lists.fedoraproject.org> <br> <b><span style="font-weight: bold;">Sent:</span></b> Thursday, May 28, 2015 2:27 AM<br> <b><span style="font-weight: bold;">Subject:</span></b> Re: [proposal] Fedora Developer Portal<br> </font> </div> <div id="yui_3_16_0_1_1432868799633_36946" class="y_msg_container"><br>On 05/27/2015 08:57 AM, Adam Samalik wrote:<br>> Hello everyone!<br>><br>> I would like to make a proposal about new project: a website for Fedora developers.<br>><br>><br>> === Why? ===<br>> - Fedora does not have a page targeted on developers like developer.ubuntu.com or developer.apple.com<br>> - Developers have no place to find out about interesting projects like Copr, Developer Assistant, etc.<br>> - There is also no place with guides and help on how to get things up and running<br>> - Current fedoraproject wiki is not designed for app developers, 'developers' on wiki essentially means Fedora packagers<br>> - There is no place for downloading (promoting) Docker images and Vagrant boxes based on Fedora<br>><br>><br>> === What? ===<br>> Create a new page: developer.fedoraproject.org - a new go-to place for app developers running Fedora.<br>><br>> The web page has would show beginners or advanced users how to install a new features on Fedora and what to do if they want to start developing something in Fedora.<br>><br>> The main categories could be something like these:<br>> 1. Development tools:<br>> - Vagrant, Developer Assistant, ...<br>> - Which tools to use for development and how they can help me<br>> - explain WHAT the project is and HOW to get it running<br>> 2. Languages, technologies, runtimnes:<br>> - Python, Ruby, Rails, Perl, ...<br>> - Info about packages, the "I am a _ developer" view<br>> - explain WHAT the project is and HOW to get it running<br>> 3. Distribution/deployment:<br>> - Copr, Docker, Openshift, ...<br>> - How to get my project to people?<br>> - explain WHAT the project is and HOW to get it running<br>> 4. Docker images, Vagrant boxes, ...<br>> 5. Blogs<br>><br>><br>> Petr Hracek and Josef Stribny and I are starting this project and I will be the one responsible for it. <br>><br>> Do you have any tips, recommendations or expectations about this project? Is there something you would like to see on the page? Let's start a discussion!<br>><br>> Thanks!<br>><br>> Adam Samalik<br>> Associate Software Engineer<br>> Red Hat<br><br>This sounds a lot like developer-focused documentation. The docs team<br>has been talking a lot about refocusing lately, and I had it in mind to<br>structure something that would provide appropriate content to users,<br>contributors, community members, and developers. It would be great if<br>we could combine efforts on this.<br><br>There's a rough concept in place that I've been *slowly* hacking at;<br>take a bunch of git repos containing source markup (ie one for each<br>current guide, one for the python SIG, one with fedora-infra SOPs, one<br>for the Server WG and edition, you get the idea) and process them. One<br>step validates and pushes strings to zanata for translation; another<br>renders to html and extracts some metadata, another step parses the<br>metadata to create a menu / site structure. The steps are run by<br>buildbot (maybe taskotron, eventually) and triggered by commits or<br>fedmsg signals, so content creators can simply write out a<br>ReStructuredText article without getting concerned about the publishing<br>process and presentation.<br><br>We've found that more people are willing to write - whether it's API<br>reference materials or general desktop usage - if their domain knowledge<br>can be the focus, and not documentation tooling and processes. We also<br>find that a git workflow enables better quality documentation and<br>fosters a sense of ownership and involvement, so the idea is to meet<br>halfway. <br><br>-- <br>-- Pete Travis<br> - Fedora Docs Project Leader<br> - 'randomuser' on freenode<br> - <a ymailto="mailto:immanetize@fedoraproject.org" href="mailto:immanetize@fedoraproject.org">immanetize@fedoraproject.org</a><br><br>-- <br>docs mailing list<br><a ymailto="mailto:docs@lists.fedoraproject.org" href="mailto:docs@lists.fedoraproject.org">docs@lists.fedoraproject.org</a><br>To unsubscribe:<br><a href="https://admin.fedoraproject.org/mailman/listinfo/docs" target="_blank">https://admin.fedoraproject.org/mailman/listinfo/docs</a><br><br></div> </div> </div> </blockquote> </div></body></html>