<html>
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div class="moz-cite-prefix">Yeah, there could be a link to
developer.fedoraproject.org too.<br>
<br>
On 05/29/2015 05:27 AM, Leslie S Satenstein wrote:<br>
</div>
<blockquote
cite="mid:11773263.1076380.1432870029322.JavaMail.yahoo@mail.yahoo.com"
type="cite">
<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 moz-do-not-send="true"
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
moz-do-not-send="true" 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);" color="green"
size="1"><span style="font-weight:bold;"></span></font><br>
</div>
<font color="green" size="2"><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 <a class="moz-txt-link-rfc2396E" href="mailto:lists@petetravis.com"><lists@petetravis.com></a><br>
<b><span style="font-weight: bold;">To:</span></b>
Adam Samalik <a class="moz-txt-link-rfc2396E" href="mailto:asamalik@redhat.com"><asamalik@redhat.com></a>;
<a class="moz-txt-link-abbreviated" href="mailto:websites@lists.fedoraproject.org">websites@lists.fedoraproject.org</a> <br>
<b><span style="font-weight: bold;">Cc:</span></b> For
participants of the Documentation Project
<a class="moz-txt-link-rfc2396E" href="mailto:docs@lists.fedoraproject.org"><docs@lists.fedoraproject.org></a> <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 moz-do-not-send="true"
ymailto="mailto:immanetize@fedoraproject.org"
href="mailto:immanetize@fedoraproject.org">immanetize@fedoraproject.org</a><br>
<br>
-- <br>
docs mailing list<br>
<a moz-do-not-send="true"
ymailto="mailto:docs@lists.fedoraproject.org"
href="mailto:docs@lists.fedoraproject.org">docs@lists.fedoraproject.org</a><br>
To unsubscribe:<br>
<a moz-do-not-send="true"
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>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
</blockquote>
<br>
<br>
<pre class="moz-signature" cols="72">--
Petr Hracek
Software Engineer
Developer Experience
Red Hat, Inc
Mob: +420777056169
email: <a class="moz-txt-link-abbreviated" href="mailto:phracek@redhat.com">phracek@redhat.com</a></pre>
</body>
</html>