<div dir="ltr"><div><div><div><div>Hi Andres,<br><br></div>The process you have proposed sounds great and I like the idea of using GitHub as a common repository for design as well as code.  I agree it will make contributions easier and provide a way to file issues against a design pattern that can help our work evolve and improve.  True, we designers will need to become more proficient in Git, but hey, it's just another tool to learn.<br><br></div>My only minor concern is the use of Markdown to create documents rather than Google Docs as is the current practice.  The markdown syntax seems simple enough to learn, but we would loose some of the more robust inline commenting features which make Google Docs great for collaboration.  Will these markdown documents be directly consumable into the site?  If so, I see this as a major advantage.<br><br></div>Anyway, I'm willing to give this a try, but it might make sense to pilot one or two pattern efforts to see how this goes.<br><br></div>Matt<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Jun 14, 2016 at 1:05 PM, Andres Galante <span dir="ltr"><<a href="mailto:agalante@redhat.com" target="_blank">agalante@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>Hi,</div><div><br></div><div>We've wrote new Contribution Guidelines to improve the way we get contributions to patternfly, and find a path for designers to participate in the community.</div><div><br></div>We want to centralise everything in github.<br><br><div>At the moment designs patterns don’t have a real place, they are spread on docs, or on the website.<br><br>We want for design specs to be living document with a fiscal representation on a github repo just as we do it with code.<br><br>The process to send code is though a github pull request. That pull request gets discuss and merge. And if we see an bug in it, we open an issue and send a new pull request with the fix. That fix is discuss again and merge.<br><br>The idea is to follow the same process for designs and designers.<br><br>We will have a repo for designs, where designers will send markdown documents. Markdown allows to easily write text and add images to describe the pattern.<br><br>Designers will send design draft on Pull Request, where we will held design discussions</div><div><br>Once we merge the design draft, it becomes a design recommendation. But of course, since it is also a living document we can send new PRs up update it.<br><br>This will also allow to easily cross reference design and code PRs in Patternfly and with other projects.<br><br>What's the cost? Designers will have to learn git. But don’t worry it's not that hard. Once you do it once then it becomes second nature, plus its super fun and it's the way open source communities works.<br><br></div><div>To pull all of this together we've wrote new contribution guidelines, and I'd love to hear your thoughts before posting them to the project:</div><div><br></div><div><a href="https://gist.github.com/andresgalante/a0d8238d8cd448b14eac9c377e76d489" target="_blank">https://gist.github.com/andresgalante/a0d8238d8cd448b14eac9c377e76d489</a></div><div><br></div><div>Thanks!</div></div>
<br>_______________________________________________<br>
Patternfly mailing list<br>
<a href="mailto:Patternfly@redhat.com">Patternfly@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/patternfly" rel="noreferrer" target="_blank">https://www.redhat.com/mailman/listinfo/patternfly</a><br>
<br></blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div><div>Matt Carrano<br></div>Sr. Interaction Designer<br></div>Red Hat, Inc.<br></div><a href="mailto:mcarrano@redhat.com" target="_blank">mcarrano@redhat.com</a><br></div></div>
</div>