Re: help wanted! please review ec2 quickstart docs
On Mar 13, 2014 3:26 PM, "Jared K. Smith" wrote: > > On Thu, Mar 13, 2014 at 12:52 PM, Jared K. Smith wrote: >> >> Just out of curiosity though, is any of this intended to make its way into the Cloud Guide? Or is Cloud Guide completely abandoned from the perspective of the Cloud SIG? > > > I really should have checked the Cloud Guide a bit closer before saying that -- it seems this page is pretty much a copy/paste from the Amazon EC2 section of the Cloud Guide. And when I went to check to see who had written that section of the Cloud Guide, I found that it was mostly me :-/ > > That still begs the question though -- does anybody else but me care about the Cloud Guide, or have any interest in working on it with me? > > -- > Jared Smith > I've poked at it in relatively recent history, and maybe even corrected the source for some of the things you've pointed out (or at least made notes :) Definitely something I'm interested in working on, but time and the experience gap have combined forces against me. -- Pete ___ cloud mailing list cloud@lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/cloud Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
Fedora Cloud Docs
Hey cloud team, I think we need some cloud docs. Fedora has a lot to offer in the cloud area, and I'm sure that those engaged in the space are excited that Fedora has what they are looking for. The uninitiated, on the other hand, are looking for what Fedora has, and we can do better to demonstrate that. We have a cloud guide, https://git.fedorahosted.org/cgit/docs/cloud-guide.git/ . It covers some basics, ie euca2ools, but never really made it out of draft state, and your work has left it far behind. We don't have anyone on the Docs team fully engaged to track the cloud space, or anyone on the cloud team engaged to maintain that guide. Also, it's written in docbook, and a lot of folks aren't into that. So, as I'm working on some tooling for a new Fedora Docs site, I'd like to know what would get *you* into writing about Fedora Cloud. In the most direct sense, it's a question about markup and delivery, ie a collection of markdown or reStructuredText files in a git repo. In a broad sense, anything along the lines of "I would write docs for using Fedora Cloud, if..." would be great. Hopefully, we can find some balance between cloud and writing expertise and deliver something exciting. At this point, I'm focusing on enabling you; let's work that out. -- -- Pete Travis - Fedora Docs Project Leader - 'randomuser' on freenode - immanet...@fedoraproject.org ___ cloud mailing list cloud@lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/cloud Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
Re: Fedora Cloud Docs
On Mar 19, 2015 6:21 AM, "Kushal Das" wrote: > > On 19/03/15, Joe Brockmeier wrote: > > On 03/19/2015 01:14 AM, Pete Travis wrote: > > > So, as I'm working on some tooling for a new Fedora Docs site, I'd like > > > to know what would get *you* into writing about Fedora Cloud. In the > > > most direct sense, it's a question about markup and delivery, ie a > > > collection of markdown or reStructuredText files in a git repo. In a > > > broad sense, anything along the lines of "I would write docs for using > > > Fedora Cloud, if..." would be great. > > > > Most of the writing I do is in Markdown. Git + Markdown would be optimal > > as far as I'm concerned. > > > > If a majority of folks who'll contribute are partial to some other > > flavor of light markup, I can go with whatever, but would prefer *not* > > Docbook or MediaWiki. Let's please do something with git to make life > > much easier. > > > Few advantages of using Sphinx and rst: > > 1. Syntax is almost like markdown. > 2. It has more features targeted towards devels. > 3. If we maintain in a public git repo, we can use a service like > readthedocs.org to build and publish the docs, we can have it in the way > of https://docs.djangoproject.com > 4. Many developers in the infra and apps teams are Python users, so they > know/use reStructuredText already. > > Kushal > -- > Fedora Cloud Engineer > CPython Core Developer > Director @ Python Software Foundation > http://kushaldas.in > ___ So we're on the same page, some context: I am working on building a backend using buildbot that we can feed arbitrary git repos containing docs written in $format and built with $tool-for-format. The goal is to have all the Fedora documentation in one well organized place with little to no contributor overhead in the process of turning markup into website. Of course, participation is welcome and encouraged on the tooling side; but I want it to be clear that it should not be a *requirement* for you to care about the tooling. If you are going to write, you should be able to focus on the writing. --Pete ___ cloud mailing list cloud@lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/cloud Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
Re: Fedora Cloud Docs
On Mar 24, 2015 11:38 AM, "Joe Brockmeier" wrote: > > On 03/24/2015 01:01 PM, Jared K. Smith wrote: > > > > If there's a particular cloud-related topic you'd like to write about -- > > go write! And then we can worry about the tooling, once there's some > > content to work with. > > I agree...ish. If Kushal, myself, mattdm, and jbrooks (for example) are > collaborating on a document, we really need a single format to target. > > Best, > > jzb > -- > I was actually polling about preferred markup format, because I am writing tools, but Jared is right: don't let things like my misadventures with python hold you back! Start now, don't worry about formats, docs will handle the business of publishing and converting. --Pete ___ cloud mailing list cloud@lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/cloud Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
Re: Why I'm excited about Atomic for Fedora
On Oct 27, 2015 7:24 PM, "Bruce Harrison" wrote: > > Matt, > > Although I just downloaded the Fedora Cloud, I want to test it and, if it is what I am looking for, let some of my customers who live on DeskTone, give this a test drive from a fast thumb drive on a laptop or even a modified Chromebook. These people are attorneys and real estate professionals that need the dependability of the cloud without Redmond controlling how they use the vehicle to get there - something lean and mean. > > If the team can get it smaller and it can access DeskTone, the universe may expand more quickly. > > Bruce > > You have me a little confused, Bruce. Fedora Cloud is an image intended to run in the cloud, to *build* services like DeskTone. You don't run it on bare metal, at least not without a lot of work - at which point, you may as well start with something different. Fedora might do what you're looking for - but what is that? --Pete ___ cloud mailing list cloud@lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/cloud Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct