Le 10. 10. 16 à 09:57, Thomas A. Schmitz a écrit :

On 10/10/2016 07:43 AM, Jonas Baggett wrote:

Thanks for your encouragement ! Yes that looks like an interesting
challenge for me, but it is not something I am wanting to do alone
because of my lack of experience, at least I would need someone to coach
me. Actually I don't have really experience with web developpment and I
would at least need help for the technological choices. Having someone
that tells me that if I use technology X, there are module Y and Z that
will be a good fit is a good start.

Just two small remarks:

1. there are not that many modules in ConTeXt because most of the functionality is in the core. If you come from the LaTeX world, you may expect several hundred packages, each with their own idiosyncracies and documentation. That's not the case here.

I wasn't thinking about ConTeXt modules here but choosing the right web framework that has the right modules.

2. As for your documentation project, let me be honest: unless someone very dedicated and very knowledgeable makes a long-term commitment and looks after these examples, they are worse than useless. Unless there is very tight control, they may contain bad and/or outdated code and lead newcomers in the wrong direction

Ok, thanks for pointing a possible problem with code quality. Yes it is something we have to think about and find a solution that will ensure good code quality among the examples. Here would be my vision for the project in 3 points : 1. It's about learning ConTeXt by examples, not only learning how to make the code work as expected, but to make it work the correct way. 2. Encourage a collaborative spirit so that the community is willing to help anyone to reach point 1 (by posting examples and making suggestion or improving existing examples).
3. See below
If this vision could be enough advertised to those who want to contribute with their examples, I believe a lot less control would be need, as the community will do the control itself.

Concerning outdated code, as I understood, the ConTeXt core interface is stable so if we add a tag for the ConTeXt Mark (II, IV, VI) that would do it. But for examples using modules, yes that's right, interfaces could change and make the existing examples outdated. So I believe that having in the database a description of the modules interface, will mitigates the problem. And when a command in a module becomes deprecated, then the description of the module interface needs to be updated and a hint could be added to fix outdated code, like : "<old command> is deprecated, replace it by <new command>". Then warnings will be added automatically on examples using outdated code with useful hints to fix it.

The context way has always been to avoid boilerplate templates and let users roll their own styles. Which makes sense since in context almost every detail can be changed easily via dedicated setup commands. (This is again quite unlike LaTeX and its document classes that predefine many details.) I have problems imagining a collection of sample documents that will be more than a haphazard bunch of fortuitous designs.

So if I understand well the philosophy difference between LaTeX and ConTeXt, the LaTeX philosophy would be about using document classes and avoid making much tweaks but be more focused on the content. With ConTeXt on the other hand, the philosophy is more about being able to customize everything.

Actually there could be 2 categories of ConTeXt documents on the database :
1. Those that are more aimed toward making others learn ConTeXt, like tutorials
2. Those who are templates.

It's very likely that the 2nd category will be more present, as I imagine that a typical contribution would be someone who spend some time with a document he has made in ConTeXt and is happy with the result and want to post it on the database in order to allow others to benefit from his work.

Indeed, the third point of my vision would be to make a big collection of templates available, but my goal isn't to go against the ConTeXt philosophy. The idea would be more like if someone has a particular need, he could find a suitable template in the database, take it, analyze it, tweak it and learn more about ConTeXt in the process. Templates would be also a good advertisement for ConTeXt : before someone could be interested in ConTeXt he has to believe that ConTeXt could fit his needs and that it hopefully isn't a pain to use. If he could find a suitable template, he would be in a very short time convinced that ConTeXt can do what he needs to and that it is nice to use thanks to its clean well-though synthax. Then he will probably become a new ConTeXt user.

I believe that having precise tags and allow to sort by popularity will help to structure the database so that it doesn't become haphazard and also the higher quality works will have more visibility.

Before starting any project it is good to analyze what are the opportunities and the risks. I was more clear about the opportunities than the risks, so thank you for pointing me the risks.

If your question is of interest to others as well, please add an entry to the 

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://context.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net

Reply via email to