On 12/07/2017 18:01, Alexandre Devaux wrote:
> Hi all,
> Great work those last weeks!
> I made a first video for the release, integrated in the old site: http://www.itowns-project.org/ > If you have some comments or want to add some of yours it is still possible.
The video is really great, I like it a lot! My only concern: does it shows some
footage of itowns1? If yes, do we care?
Maybe we shouldn't show stuff we can't do right now (meaning: that itowns#master
or a public branch cannot do). Once they land, we can add it back to the video.
Or do you consider this video as "showcase of what we can potentially do with
itowns, even though not everything is easily possible right now"? WDYT?
> Ideally for FOSS4G start, 18/19th of July we should have:
> - New website for release 2.0
> - Tutorials
I'm not sure what you call tutorials, but I suggest to start with annotated
examples. They are faster to make, faster to read for the user, and can convey
as much information as a tutorial, while always be kept up-to-date (because we
actually test them).
For this, I planned to auto-generate webpages from examples/. And I think docco
is great for that. Here is an example Pierre-Éric made some weeks ago:
http://22.214.171.124/itowns-docs/planar.html. The comments are turned into
text, the code into code block and you have the running examples at the end.
With a bit more comments, they could very well be called tutorials, right? Once
the glue is there, they'll get updated automatically as we update/add examples
to our codebase. WDYT?
> - Explicit roadmap
> Are you still in the mood to work on the website Augustin? Or should we just refresh the actual one?
Yes, I think I'll have some bandwidth next week for that. Don't expect a full
refresh though, I'm going to start with the most urgent (linking the doc, making
an example page, removing itowns1 screenshots etc...). Basically making it more
efficient and up-to-date. Also, I think I'll change it to make more *.md files
as opposed to html files, to make small editions easier.