On Mon, Feb 13, 2017 at 7:13 PM, Didier Roche <didro...@ubuntu.com> wrote:
> Le 10/02/2017 à 17:30, Simos Xenitellis a écrit :
>> On Tue, Feb 7, 2017 at 3:54 PM, Didier Roche <didro...@ubuntu.com> wrote:
>>> Le 07/02/2017 à 14:05, Simos Xenitellis a écrit :
>>>> On Tue, Feb 7, 2017 at 9:13 AM, Didier Roche <didro...@ubuntu.com> wrote:
>>>>> Le 06/02/2017 à 10:56, Simos Xenitellis a écrit :
>>>>>> Hi All,
>>>>>>
>>>>>> I wrote an article about creating a snap for an existing Python
>>>>>> program using the new snapcraft 2.26. Then, I uploaded to the Ubuntu
>>>>>> Store.
>>>>>>
>>>>>> I am looking forward to receiving feedback :-)
>>>>>>
>>>>>> Link: 
>>>>>> https://blog.simos.info/how-to-create-a-snap-for-a-python-app-with-networking-using-snapcraft-in-ubuntu-16-04/
>>>>>>
>>>>>> Link to HN submission: https://news.ycombinator.com/item?id=13578034
>>>>>>
>>>>>> Simos
>>>>>>
>>>>> Excellent work Simos!
>>>>>
>>>>> I think this kind of content would make an excellent official "pratical"
>>>>> tutorials on https://tutorials.ubuntu.com. Are you interested into
>>>>> contributing there?
>>>>>
>>>>> If you want more context on tutorials, the phisolophy and how to
>>>>> contribute, I wrote a blog post some time ago about it:
>>>>> https://insights.ubuntu.com/2017/01/20/tutorials-ubuntu-com-goes-live/.
>>>>>
>>>>> I'm also available for any help,
>>>> Thanks Didier!
>>>>
>>>> I had a look at https://github.com/ubuntudesign/tutorials.ubuntu.com/issues
>>>> and the direction that tutorials.ubuntu.com wants to take. It looks good.
>>>> It requires planning in terms of the writing of the tutorials so that
>>>> they are gradually incremental,
>>>> and some basic tutorials can referenced by the more complex ones. It's
>>>> a lot of dedicated work.
>>>>
>>>> I'll give it a go and try to write a couple of tutorials for
>>>> tutorials.ubuntu.com. We will see how it goes :-)
>>>> I think I'll start with the baseline tutorial for snapcraft.
>>> Excellent news!
>>> You can as well convert some of yours to this format! I give you the
>>> direct link to the guidelines to have some coherences between the
>>> tutorials in term of tones and content:
>>> https://docs.google.com/document/d/1u5qmSNIcE8SjuAg6aKjTxOBGWIjBW0kYf01t4Dfw6-U/edit.
>>>
>> I managed to complete the conversion and the tutorial is ready :-).
>>
>> Here it is,
>> https://docs.google.com/document/d/1Nk-kw79lt84YJNEKS_WpnGzVSjrmCUVd1TsAx5aRoOA/
>> Feel free to add to tutorials.ubuntu.com or make a copy in order to edit.
>>
>> Overall, the experience in converting to the format required by
>> codelabs was interesting.
>> I still need more practice before I would be able to write a tutorial
>> in one go in the codelab style.
>
> This really looks awesome! Thanks Simos :)
>
> I'll add some very small tweaking, but after a first look, it's very a
> nice first shot. Well done :)

Thanks!

> I would be interested in any comment you have about the codelab format
> and style, and anything you liked/didn't like.
>

The environment about the command-line snippets,
https://docs.google.com/document/d/1u5qmSNIcE8SjuAg6aKjTxOBGWIjBW0kYf01t4Dfw6-U/edit#heading=h.6e9eqf6ttpj
could be enhanced by distinguishing the actual commands that the user
is expected to type (and run).

That is, if you make "bold" part of a command-line snippet, then the
"bold" part will appear differently in order to show that it is about
text to be typed by the user.

In addition, if a user double-clicks on such user-input, then it
should ideally select only the user-input and not the prompt
characters.

I filed a feature request at https://github.com/googlecodelabs/tools/issues/24

> I'll keep you posted with a diff so that you can see what small
> modifications I made to be more coherent with the other ones.
>

Thanks, looking forward to reading the changes.

Cheers,
Simos

> If you have any other to do, do not hesitate to keep us posted!
> Cheers,
> Didier
>
> --
> Snapcraft mailing list
> Snapcraft@lists.snapcraft.io
> Modify settings or unsubscribe at: 
> https://lists.ubuntu.com/mailman/listinfo/snapcraft

-- 
Snapcraft mailing list
Snapcraft@lists.snapcraft.io
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/snapcraft

Reply via email to