On Sun, Nov 03, 2019 at 06:59:08PM +0000, brian m. carlson wrote: > > I would really like to see a simple example of such template, so that > > even people who are unfamiliar with Ruby's ERB can think of equivalent > > solution for their language or toolchain of choice. > > I hesitated to mention ERB, but I wasn't sure that folks would know what > we meant by a "templating mechanism". The reason I had chosen to > mention it is that someone could search for "Ruby ERB" and find out what > it looked like and then look for an option in their own language. I don't mind what is here, but I might even suggest going slightly in the opposite direction. Say something like: For example, you the repository can include a sample config file that can then be copied into the ignored name and modified. which points people in the right direction without giving specifics. But if you did want to go further, you can then say: The repository can even include a script to treat the sample file as a template, modifying and copying it automatically (e.g., a Ruby script using an ERB template). or something. > My concern with adding such a template is that an example will likely > grow this section quite a bit, and it's meant as a short aside to help > people avoid making a common mistake and guide them to a proper solution > rather than a comprehensive howto. Yeah. I don't think we should get into best practices for using ERB. -Peff
