Re: Juju Academy
This is awesome Marco, Well Done! -Sean On Wed, May 7, 2014 at 12:16 PM, Marco Ceppi wrote: > Hi everyone! > > I was trying to keep this under wraps as I worked on it more before > announcing to the world but I'm too excited with the progress so far so > here's the "SUPER ALPHA BETA OMEGA" introduction to Juju Academy. > > I started this, http://juju.academy (http://learnjuju.com) based on my > own experiences when trying new software. Primarily modeled after the Learn > Go Lang webiste (http://tour.golang.org/) I set out to create an easy > platform that emulates a terminal environment and allows a user to try Juju > before ever having to install it. In addition I wanted to make a > lightweight lesson framework to help guide new users in this exciting new > Service Orchestration paradigm. Finally, the last goal of this project was > to build an easy to embed module that could live in the docs to provide > very lightweight terminal sessions that users could use to review what > portions of the docs they were reading. > > Right now I've modeled just a hand full of lessons and only a few of the > juju commands have actually been implemented. As this is a spare time > project progress comes in chunks of time over the weekend and in the > evenings. However, if you're interested in piloting the demoware and > shaking out bugs please do so! You can view the lessons at > http://juju.academy the source code is > https://github.com/marcoceppi/juju-academy and the issue tracker is on > that repo. > > Your juju environment(s) persist not only between lessons but also between > page visits. If at anytime you wish to start anew you can do so by issuing > the "reset" command in the terminal. I'm working on finishing > http://help.juju.academy which will have this and other FAQ/Guide like > questions to use the software. All Juju help can be found, as always, at > https://juju.ubuntu.com/docs > > This is also a call for help! Anyone interested in writing lessons, > command modules, fixing bugs, making this look nicer, etc - pull requests > are welcome! The entire project aims to be modular (in that this framework > could be used for non juju terminal lessons). Lessons are simply JSONP > files that contain a set number of keys and commands are functions that > perform some rudimentary validation. > > I eagerly await feedback and have had an immense amount of fun working on > this so far! I'll likely follow up with a more official announcement when > more of the commands have been implemented. > > Thanks, > Marco Ceppi > > -- > Juju mailing list > j...@lists.ubuntu.com > Modify settings or unsubscribe at: > https://lists.ubuntu.com/mailman/listinfo/juju > > -- Juju-dev mailing list Juju-dev@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/juju-dev
Re: Juju Academy
Nate, thanks for reminding me, juju help commands is also wrong! https://bugs.launchpad.net/juju-core/+bug/1299120 On Wed, May 7, 2014 at 7:27 PM, Nate Finch wrote: > Actually, init is the main command, generate-config is an alias for init > (see juju help commands). > > > On Wed, May 7, 2014 at 1:55 PM, Nick Veitch > wrote: >> >> Nice work, when it is ready we can add it to the getting started >> section of the docs too. >> >> Small point - 'juju generate-config', not 'juju init', you may await my PR >> >> On Wed, May 7, 2014 at 6:24 PM, Gustavo Niemeyer >> wrote: >> > This is _extremely_ cool, Marco. Very well done! >> > >> > One tiny suggestion, for anyone interested in contributing: it would >> > be great to have "ls [-la]" at some point. That's the first thing most >> > people will type when seeing a prompt, and gives them room for >> > navigating to the juju configuration directory. >> > >> > On Wed, May 7, 2014 at 1:16 PM, Marco Ceppi wrote: >> >> Hi everyone! >> >> >> >> I was trying to keep this under wraps as I worked on it more before >> >> announcing to the world but I'm too excited with the progress so far so >> >> here's the "SUPER ALPHA BETA OMEGA" introduction to Juju Academy. >> >> >> >> I started this, http://juju.academy (http://learnjuju.com) based on my >> >> own >> >> experiences when trying new software. Primarily modeled after the Learn >> >> Go >> >> Lang webiste (http://tour.golang.org/) I set out to create an easy >> >> platform >> >> that emulates a terminal environment and allows a user to try Juju >> >> before >> >> ever having to install it. In addition I wanted to make a lightweight >> >> lesson >> >> framework to help guide new users in this exciting new Service >> >> Orchestration >> >> paradigm. Finally, the last goal of this project was to build an easy >> >> to >> >> embed module that could live in the docs to provide very lightweight >> >> terminal sessions that users could use to review what portions of the >> >> docs >> >> they were reading. >> >> >> >> Right now I've modeled just a hand full of lessons and only a few of >> >> the >> >> juju commands have actually been implemented. As this is a spare time >> >> project progress comes in chunks of time over the weekend and in the >> >> evenings. However, if you're interested in piloting the demoware and >> >> shaking >> >> out bugs please do so! You can view the lessons at http://juju.academy >> >> the >> >> source code is https://github.com/marcoceppi/juju-academy and the issue >> >> tracker is on that repo. >> >> >> >> Your juju environment(s) persist not only between lessons but also >> >> between >> >> page visits. If at anytime you wish to start anew you can do so by >> >> issuing >> >> the "reset" command in the terminal. I'm working on finishing >> >> http://help.juju.academy which will have this and other FAQ/Guide like >> >> questions to use the software. All Juju help can be found, as always, >> >> at >> >> https://juju.ubuntu.com/docs >> >> >> >> This is also a call for help! Anyone interested in writing lessons, >> >> command >> >> modules, fixing bugs, making this look nicer, etc - pull requests are >> >> welcome! The entire project aims to be modular (in that this framework >> >> could >> >> be used for non juju terminal lessons). Lessons are simply JSONP files >> >> that >> >> contain a set number of keys and commands are functions that perform >> >> some >> >> rudimentary validation. >> >> >> >> I eagerly await feedback and have had an immense amount of fun working >> >> on >> >> this so far! I'll likely follow up with a more official announcement >> >> when >> >> more of the commands have been implemented. >> >> >> >> Thanks, >> >> Marco Ceppi >> >> >> >> -- >> >> Juju mailing list >> >> j...@lists.ubuntu.com >> >> Modify settings or unsubscribe at: >> >> https://lists.ubuntu.com/mailman/listinfo/juju >> >> >> > >> > >> > >> > -- >> > >> > gustavo @ http://niemeyer.net >> > >> > -- >> > Juju mailing list >> > j...@lists.ubuntu.com >> > Modify settings or unsubscribe at: >> > https://lists.ubuntu.com/mailman/listinfo/juju >> >> >> >> -- >> Nick Veitch >> nick.vei...@canonical.com >> >> -- >> Juju mailing list >> j...@lists.ubuntu.com >> Modify settings or unsubscribe at: >> https://lists.ubuntu.com/mailman/listinfo/juju > > -- Nick Veitch nick.vei...@canonical.com -- Juju-dev mailing list Juju-dev@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/juju-dev
Re: Juju Academy
Actually, init is the main command, generate-config is an alias for init (see juju help commands). On Wed, May 7, 2014 at 1:55 PM, Nick Veitch wrote: > Nice work, when it is ready we can add it to the getting started > section of the docs too. > > Small point - 'juju generate-config', not 'juju init', you may await my PR > > On Wed, May 7, 2014 at 6:24 PM, Gustavo Niemeyer > wrote: > > This is _extremely_ cool, Marco. Very well done! > > > > One tiny suggestion, for anyone interested in contributing: it would > > be great to have "ls [-la]" at some point. That's the first thing most > > people will type when seeing a prompt, and gives them room for > > navigating to the juju configuration directory. > > > > On Wed, May 7, 2014 at 1:16 PM, Marco Ceppi wrote: > >> Hi everyone! > >> > >> I was trying to keep this under wraps as I worked on it more before > >> announcing to the world but I'm too excited with the progress so far so > >> here's the "SUPER ALPHA BETA OMEGA" introduction to Juju Academy. > >> > >> I started this, http://juju.academy (http://learnjuju.com) based on my > own > >> experiences when trying new software. Primarily modeled after the Learn > Go > >> Lang webiste (http://tour.golang.org/) I set out to create an easy > platform > >> that emulates a terminal environment and allows a user to try Juju > before > >> ever having to install it. In addition I wanted to make a lightweight > lesson > >> framework to help guide new users in this exciting new Service > Orchestration > >> paradigm. Finally, the last goal of this project was to build an easy to > >> embed module that could live in the docs to provide very lightweight > >> terminal sessions that users could use to review what portions of the > docs > >> they were reading. > >> > >> Right now I've modeled just a hand full of lessons and only a few of the > >> juju commands have actually been implemented. As this is a spare time > >> project progress comes in chunks of time over the weekend and in the > >> evenings. However, if you're interested in piloting the demoware and > shaking > >> out bugs please do so! You can view the lessons at http://juju.academythe > >> source code is https://github.com/marcoceppi/juju-academy and the issue > >> tracker is on that repo. > >> > >> Your juju environment(s) persist not only between lessons but also > between > >> page visits. If at anytime you wish to start anew you can do so by > issuing > >> the "reset" command in the terminal. I'm working on finishing > >> http://help.juju.academy which will have this and other FAQ/Guide like > >> questions to use the software. All Juju help can be found, as always, at > >> https://juju.ubuntu.com/docs > >> > >> This is also a call for help! Anyone interested in writing lessons, > command > >> modules, fixing bugs, making this look nicer, etc - pull requests are > >> welcome! The entire project aims to be modular (in that this framework > could > >> be used for non juju terminal lessons). Lessons are simply JSONP files > that > >> contain a set number of keys and commands are functions that perform > some > >> rudimentary validation. > >> > >> I eagerly await feedback and have had an immense amount of fun working > on > >> this so far! I'll likely follow up with a more official announcement > when > >> more of the commands have been implemented. > >> > >> Thanks, > >> Marco Ceppi > >> > >> -- > >> Juju mailing list > >> j...@lists.ubuntu.com > >> Modify settings or unsubscribe at: > >> https://lists.ubuntu.com/mailman/listinfo/juju > >> > > > > > > > > -- > > > > gustavo @ http://niemeyer.net > > > > -- > > Juju mailing list > > j...@lists.ubuntu.com > > Modify settings or unsubscribe at: > https://lists.ubuntu.com/mailman/listinfo/juju > > > > -- > Nick Veitch > nick.vei...@canonical.com > > -- > Juju mailing list > j...@lists.ubuntu.com > Modify settings or unsubscribe at: > https://lists.ubuntu.com/mailman/listinfo/juju > -- Juju-dev mailing list Juju-dev@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/juju-dev
Re: Juju Academy
Nice work, when it is ready we can add it to the getting started section of the docs too. Small point - 'juju generate-config', not 'juju init', you may await my PR On Wed, May 7, 2014 at 6:24 PM, Gustavo Niemeyer wrote: > This is _extremely_ cool, Marco. Very well done! > > One tiny suggestion, for anyone interested in contributing: it would > be great to have "ls [-la]" at some point. That's the first thing most > people will type when seeing a prompt, and gives them room for > navigating to the juju configuration directory. > > On Wed, May 7, 2014 at 1:16 PM, Marco Ceppi wrote: >> Hi everyone! >> >> I was trying to keep this under wraps as I worked on it more before >> announcing to the world but I'm too excited with the progress so far so >> here's the "SUPER ALPHA BETA OMEGA" introduction to Juju Academy. >> >> I started this, http://juju.academy (http://learnjuju.com) based on my own >> experiences when trying new software. Primarily modeled after the Learn Go >> Lang webiste (http://tour.golang.org/) I set out to create an easy platform >> that emulates a terminal environment and allows a user to try Juju before >> ever having to install it. In addition I wanted to make a lightweight lesson >> framework to help guide new users in this exciting new Service Orchestration >> paradigm. Finally, the last goal of this project was to build an easy to >> embed module that could live in the docs to provide very lightweight >> terminal sessions that users could use to review what portions of the docs >> they were reading. >> >> Right now I've modeled just a hand full of lessons and only a few of the >> juju commands have actually been implemented. As this is a spare time >> project progress comes in chunks of time over the weekend and in the >> evenings. However, if you're interested in piloting the demoware and shaking >> out bugs please do so! You can view the lessons at http://juju.academy the >> source code is https://github.com/marcoceppi/juju-academy and the issue >> tracker is on that repo. >> >> Your juju environment(s) persist not only between lessons but also between >> page visits. If at anytime you wish to start anew you can do so by issuing >> the "reset" command in the terminal. I'm working on finishing >> http://help.juju.academy which will have this and other FAQ/Guide like >> questions to use the software. All Juju help can be found, as always, at >> https://juju.ubuntu.com/docs >> >> This is also a call for help! Anyone interested in writing lessons, command >> modules, fixing bugs, making this look nicer, etc - pull requests are >> welcome! The entire project aims to be modular (in that this framework could >> be used for non juju terminal lessons). Lessons are simply JSONP files that >> contain a set number of keys and commands are functions that perform some >> rudimentary validation. >> >> I eagerly await feedback and have had an immense amount of fun working on >> this so far! I'll likely follow up with a more official announcement when >> more of the commands have been implemented. >> >> Thanks, >> Marco Ceppi >> >> -- >> Juju mailing list >> j...@lists.ubuntu.com >> Modify settings or unsubscribe at: >> https://lists.ubuntu.com/mailman/listinfo/juju >> > > > > -- > > gustavo @ http://niemeyer.net > > -- > Juju mailing list > j...@lists.ubuntu.com > Modify settings or unsubscribe at: > https://lists.ubuntu.com/mailman/listinfo/juju -- Nick Veitch nick.vei...@canonical.com -- Juju-dev mailing list Juju-dev@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/juju-dev
Re: Juju Academy
This is _extremely_ cool, Marco. Very well done! One tiny suggestion, for anyone interested in contributing: it would be great to have "ls [-la]" at some point. That's the first thing most people will type when seeing a prompt, and gives them room for navigating to the juju configuration directory. On Wed, May 7, 2014 at 1:16 PM, Marco Ceppi wrote: > Hi everyone! > > I was trying to keep this under wraps as I worked on it more before > announcing to the world but I'm too excited with the progress so far so > here's the "SUPER ALPHA BETA OMEGA" introduction to Juju Academy. > > I started this, http://juju.academy (http://learnjuju.com) based on my own > experiences when trying new software. Primarily modeled after the Learn Go > Lang webiste (http://tour.golang.org/) I set out to create an easy platform > that emulates a terminal environment and allows a user to try Juju before > ever having to install it. In addition I wanted to make a lightweight lesson > framework to help guide new users in this exciting new Service Orchestration > paradigm. Finally, the last goal of this project was to build an easy to > embed module that could live in the docs to provide very lightweight > terminal sessions that users could use to review what portions of the docs > they were reading. > > Right now I've modeled just a hand full of lessons and only a few of the > juju commands have actually been implemented. As this is a spare time > project progress comes in chunks of time over the weekend and in the > evenings. However, if you're interested in piloting the demoware and shaking > out bugs please do so! You can view the lessons at http://juju.academy the > source code is https://github.com/marcoceppi/juju-academy and the issue > tracker is on that repo. > > Your juju environment(s) persist not only between lessons but also between > page visits. If at anytime you wish to start anew you can do so by issuing > the "reset" command in the terminal. I'm working on finishing > http://help.juju.academy which will have this and other FAQ/Guide like > questions to use the software. All Juju help can be found, as always, at > https://juju.ubuntu.com/docs > > This is also a call for help! Anyone interested in writing lessons, command > modules, fixing bugs, making this look nicer, etc - pull requests are > welcome! The entire project aims to be modular (in that this framework could > be used for non juju terminal lessons). Lessons are simply JSONP files that > contain a set number of keys and commands are functions that perform some > rudimentary validation. > > I eagerly await feedback and have had an immense amount of fun working on > this so far! I'll likely follow up with a more official announcement when > more of the commands have been implemented. > > Thanks, > Marco Ceppi > > -- > Juju mailing list > j...@lists.ubuntu.com > Modify settings or unsubscribe at: > https://lists.ubuntu.com/mailman/listinfo/juju > -- gustavo @ http://niemeyer.net -- Juju-dev mailing list Juju-dev@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/juju-dev
Re: Developer docs
I volunteer to: * Manage the markdown->html stuff * Create a sensible structure for the docs * Make helpful suggestions like "shouldn't there be a section on how providers work and how to write your own?" On Wed, May 7, 2014 at 6:35 AM, Frank Mueller wrote: > Hi, > > I'm still on silver wedding journey, so I'm not snchronized with all > discussions. Currently I'm supporting Nick writing the docs from the user > perspective, but I'm thinking about the dev docs since a longer time. So I'm > raising my hand for writing those docs when I'm back next week. > > mue > > Am Mittwoch, 7. Mai 2014 schrieb Tim Penhey : > >> Here are some notes from the discussion we had last week. >> >> A key part was to make sure that the developer documentation was >> available outside the actual source tree. We thought something like: >> >>https://juju.ubuntu.com/dev/ - Developer Documentation >> >> The actual files are in the source tree in the doc directory, and we >> have a process (read script magic) that takes the markdown formatted >> local files and creates pretty HTML for the website. This should happen >> automagically every time we have a stable release. >> >> There was a list of topics that we need to make sure are covered: >> >> * Architecture overview >> * API overview >> * Writing new API calls >> * What is in state (our persistent store - horrible name, I know) >> * How the mgo transactions work >> * How to write tests >> * base suites >> * environment isolation >> * patch variables and environment >> * using gocheck (filter and verbose) >> * table based tests vs. simple tests >> * test should be small and obviously correct >> * Developer environment setup >> * How to run the tests >> * juju test --no-log (plugin) >> >> >> And a side note: >> https://juju.ubuntu.com/install/ should say install juju-local >> >> Now we need people to put their hands up and write the docs. Since I'm >> first, I get to choose first (bwahaha), and I choose the "how to write >> tests". >> >> I'm also pretty keen on the 'juju-test' plugin. Partly because I don't >> like typing the command line args all the time for verbose logs and >> filter stuff, so would like it easier. >> >> I think a side part of the juju-test plugin is that it is conceivable >> that the plugin could output subunit output (optionally) for hooking >> into other test tools. >> >> I have a feeling that there will be some files in the doc directory that >> we don't want up on the website (maybe), so I envision that someone will >> end up writing the script that manages the structure and conversion of >> the raw files. >> >> Comments or claims? >> >> Tim >> >> -- >> Juju-dev mailing list >> Juju-dev@lists.ubuntu.com >> Modify settings or unsubscribe at: >> https://lists.ubuntu.com/mailman/listinfo/juju-dev > > > > -- > ** Frank Mueller > ** Software Engineer - Juju Development > ** Canonical > > > -- > Juju-dev mailing list > Juju-dev@lists.ubuntu.com > Modify settings or unsubscribe at: > https://lists.ubuntu.com/mailman/listinfo/juju-dev > -- Nick Veitch nick.vei...@canonical.com -- Juju-dev mailing list Juju-dev@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/juju-dev
