-
Notifications
You must be signed in to change notification settings - Fork 6.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Please start providing context for nuanced config settings. #6068
Conversation
Every config I have seen lacks context. When dealing with complex configs, we need to start providing the settings around the configuration options of interest in case other passer-bys are looking for where to include these specific and nuanced settings. This is the only page that talks about scss being used in angular-cli.json
@mmalerba Why is travis-ci linter failing? This isn't a code change it's a documentation change. |
@megamindbrian looks like a lint error that was accidentally merged into master a while back. It has since been fixed and will probably go away if you rebase |
@mmalerba How do I rebase a commit made through Githubs editor? All the changes are stored online so I don't have a separate branch. How do I checkout |
I'll just ignore the lint issue warning merge after this is LGTM'd, since it's clearly unrelated to your changes |
Great!
…On Tue, Aug 8, 2017 at 1:32 PM, mmalerba ***@***.***> wrote:
I'll just ignore the lint issue warning merge after this is LGTM'd, since
it's clearly unrelated to your changes
—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
<#6068 (comment)>,
or mute the thread
<https://github.com/notifications/unsubscribe-auth/AX5XbqlzM4so4q0CGT0zkHFFFcGJ-s5gks5sWMXHgaJpZM4OkWTl>
.
|
I don't think this is the place to describe what the config file should look like; that level of detail belongs to the angular-cli documentation |
You're wrong. What is there is meaningless without context. Showing that
the angular/material2 theme can be imported by the styles: [] section of
config is your responsibility since it is already on the page, and it is
meaningless without context. It's also hard to read the way it currently
exists.
…On Thu, Aug 17, 2017 at 10:39 AM, Jeremy Elbourn ***@***.***> wrote:
Closed #6068 <#6068>.
—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
<#6068 (comment)>, or mute
the thread
<https://github.com/notifications/unsubscribe-auth/AX5XbkpvobCyGvzyMa0sBPokDkEZqWKHks5sZHrrgaJpZM4OkWTl>
.
|
@megamindbrian what context is missing? That paragraph tells you
The only improvement I could see is changing |
Where is styles?
…On Thu, Aug 17, 2017 at 12:35 PM, Will Howell ***@***.***> wrote:
If you are using the Angular CLI, support for compiling Sass to css is
built-in; you only have to add a new entry to the "styles" list in
angular-cli.json pointing to the theme file (e.g., unicorn-app-theme.scss
).
@megamindbrian <https://github.com/megamindbrian> what context is
missing? That paragraph tells you
1. What entry you need to add
2. What file you need to add it to
3. Where in that file you should add it
The only improvement I could see is changing angular-cli.json to
.angular-cli.json to match recent cli updates.
—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
<#6068 (comment)>,
or mute the thread
<https://github.com/notifications/unsubscribe-auth/AX5XbtM2sGwCbE4Os5xj3C-yIUH7hUuhks5sZJYSgaJpZM4OkWTl>
.
|
|
@willshowell The current instructions don't represent the final result. Those 3 statements in 1 sentence don't look like a configuration. No matter what your argument is, a sentence:
Does not look like a config change. Why shouldn't documentation follow the same SOLID principles that code does? Documentation should look like the expected result.
When I scroll though the page and I see a code block, I think "Oh! That must be a config change!". When I scroll through and I see 1 line out of hundreds that describes the name of the file, that line does not look like a config change. That looks like some arbitrary instructions. You could even number the steps if that would be better. |
this scss is still not fixed. :( no matter i do i get this, i use 9 themes, all dynamic, the aot built no warning but in dev it shows warning and i do use the @mat-core, i even include every where. does it only work i just use webpack. that's all plus |
This issue has been automatically locked due to inactivity. Read more about our automatic conversation locking policy. This action has been performed automatically by a bot. |
Every config I have seen lacks context. When dealing with complex configs, we need to start providing the settings around the configuration options of interest in case other passer-bys are looking for where to include these specific and nuanced settings. This is the only page that talks about scss being used in angular-cli.json