Skip to content
This repository has been archived by the owner on Jan 23, 2023. It is now read-only.

Configuration motivation #24

Open
1 of 3 tasks
flut1 opened this issue Jul 13, 2016 · 3 comments
Open
1 of 3 tasks

Configuration motivation #24

flut1 opened this issue Jul 13, 2016 · 3 comments
Assignees

Comments

@flut1
Copy link
Contributor

flut1 commented Jul 13, 2016

When there is some kind of strange configuration in webpack, karma or typescript we sometimes add comments to explain why it is there. I think it would be nice if we would have a document where we explain our motivation behind all the configuration options.

I would like to create this document, but right now there is no separation between the boilerplate documentation (for the new module) and the readme for the boilerplate itself.

  • create configuration page
  • add description for each config file
  • link to configuration page from readme
@flut1 flut1 self-assigned this Jul 13, 2016
@flut1
Copy link
Contributor Author

flut1 commented Jul 13, 2016

Possible solution for the README.md below. We would strip the wiki link when using generator-seng-module

seng-boilerplate

This README contains boilerplate documentation for your new seng module. For usage instructions of seng-boilerplate, please see our wiki pages.

@VictorGa
Copy link

+1

Agree with the solution, all documentation related with instructing, examples and demos should be in other section like wiki or even an external web site

@ThaNarie
Copy link
Member

Boilerplate info is now placed at the bottom of the readme (that's stripped of in the generator), but moving it to github wiki pages might be a better option.

Note, before removing the bottom part of the readme, we probably need to update the yeoman generator to make sure it doesn't break at the indexOf being -1 :)

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants