Skip to content
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

Document code structure in root readme #2220

Merged
merged 7 commits into from
May 20, 2020
Merged

Document code structure in root readme #2220

merged 7 commits into from
May 20, 2020

Conversation

markfields
Copy link
Member

@markfields markfields commented May 18, 2020

Working on #1879

All the links in that tree go to directories with a readme, but some/many of those need to be updated still.

What do you think of how this info is presented? Looking for lots of feedback!

* [Packages](./packages)
* [Example Components](./components/examples)
* [Experimental Components](./components/experimental)
* [Example host](./examples/hosts/iframe-host)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a prototype for hosting in an iframe, i would put this below with other example hosts

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But for some reason it's included in the client minirepo lerna.json. @curtisman

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@anthony-murphy - Actually looks like you're the one who added it to lerna.json. Was there a reason you wanted it building/versioned with packages instead of standing alone?

https://github.com/microsoft/FluidFramework/pull/1328/files#diff-52d4bf43db96176e77cc9038a78f98e1

@tylerbutler
Copy link
Member

Does this need to say much more than, "A shared ESLint config used by all the Fluid Framework packages"?


Refers to: common/build/eslint-config-fluid/README.md:4 in 0b5894e. [](commit_id = 0b5894e, deletion_comment = False)

@@ -1,3 +1,3 @@
# Fluid Common Definitions

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: I would prefer "Sentence casing" instead of "Title Casing". But really, shouldn't this be the name of the package itself?

Copy link
Member Author

@markfields markfields May 18, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah I like using the package name. Once we rev our package names to use the @fluidframework scope I'll make a pass and ensure there's a readme alongside every package.json with the package name as the title.

@tylerbutler
Copy link
Member

If you're only waiting for a sentence description here let me know and I can whip one up.


Refers to: components/examples/README.md:4 in 0b5894e. [](commit_id = 0b5894e, deletion_comment = False)

README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
@markfields markfields mentioned this pull request May 18, 2020
10 tasks
@markfields
Copy link
Member Author

@tylerbutler - Happy to drop in any copy you send me, I just didn't want to block/hold myself up on trying to write words.

README.md Outdated Show resolved Hide resolved
Copy link
Member

@curtisman curtisman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:shipit:

@markfields markfields merged commit 71f1831 into microsoft:master May 20, 2020
@markfields markfields deleted the dir-structure branch May 20, 2020 16:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants