-
Notifications
You must be signed in to change notification settings - Fork 2.4k
3.0 polymer.json - add new options & restructure TOC #2498
Conversation
Do you want a review on this, or are you going to do another update first? |
Probably needs another update first. Thanks
…On Mon, Mar 19, 2018 at 10:43 AM Arthur Evans ***@***.***> wrote:
Do you want a review on this, or are you going to do another update first?
—
You are receiving this because you authored the thread.
Reply to this email directly, view it on GitHub
<#2498 (comment)>, or mute
the thread
<https://github.com/notifications/unsubscribe-auth/AVLM4af97mdK4Jblb-uitihSmTwTfPrjks5tf-5FgaJpZM4SssIs>
.
|
Ready for review @arthurevans |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Left minor comments. Staged version is messed up. Since it's a big reorg, can you restage it so I can get a better idea of what it looks like? Thx.
app/3.0/docs/tools/polymer-json.md
Outdated
### entrypoint | ||
Optional, Defaults to `index.html`<br> | ||
Type: `String` | ||
**Quick reference** {#quickreference} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This should be a header, not just bolded.
app/3.0/docs/tools/polymer-json.md
Outdated
shell file specified in the shell property. It should be as small as possible since it’s served for | ||
all routes. All paths in the entrypoint should be absolute, because this file is served from many | ||
different URLs. | ||
* [`root`](#root): Specify the path to the root project folder |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
End bullets with period.
Minor nit, but other lists like this in the docs we have Keyword
. Description. Rather than Keyword
: Description.
app/3.0/docs/tools/polymer-json.md
Outdated
Creating a `polymer.json` in your project directory allows you to store information about your | ||
project structure and desired build configuration(s). It is used by the [Polymer CLI](polymer-cli) | ||
as a way to understand the structure of your application. | ||
Create a `polymer.json` file in your root project folder to configure the behavior of [Polymer CLI](polymer-cli) tools for your Polymer project. See the [Polymer 3.0 Sample App](https://github.com/PolymerLabs/start-polymer3/blob/master/polymer.json) for a working example. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
root => top-level maybe?
Root has so many meanings (there's a project root in the polymer.json which may not be the same as the folder that polymer.json is in, server root, filesystem root, etc.) that it might be good not to reuse it here.
Thanks @arthurevans. Fixed things and redeployed it. |
https://polymer-json-dot-polymer-project.appspot.com