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

☂️ Move content out of /guides directory to more fitting homes #5767

Open
parlough opened this issue May 4, 2024 · 0 comments
Open

☂️ Move content out of /guides directory to more fitting homes #5767

parlough opened this issue May 4, 2024 · 0 comments
Assignees
Labels
a.language Relates to the Dart language tour e3-weeks Complete in < 4 weeks of normal, not dedicated, work infra.ia Relates to the organization of pages and structuring of content meta.umbrella Collects multiple related issues p2-medium Necessary but not urgent concern. Resolve when possible. st.triage.ltw Indicates Lead Tech Writer has triaged

Comments

@parlough
Copy link
Member

parlough commented May 4, 2024

The directory was kind of a catch-all. Move content out of it to a more content-related destination, or remove it if not helpful anymore.

@parlough parlough added a.language Relates to the Dart language tour p3-low Valid but not urgent concern. Resolve when possible. Encourage upvote to surface. e3-weeks Complete in < 4 weeks of normal, not dedicated, work infra.ia Relates to the organization of pages and structuring of content meta.umbrella Collects multiple related issues labels May 4, 2024
MaryaBelanger added a commit that referenced this issue May 6, 2024
Contributes to #5766 and
#5767

Co-authored-by: Marya <111139605+MaryaBelanger@users.noreply.github.com>
parlough added a commit that referenced this issue May 6, 2024
Contributes to #5767 and
#4565 by moving a few
isolated pages within the `/guides` directory that have an existing
suitable location to there.

These are grouped as an initial step as they don't require larger
content or restructuring changes, unlike some other pages within the
`/guides` directory.

| Original location | New location |
|--------|--------|
| `/guides/libraries/useful-libraries` | `/resources/useful-packages` |
| `/guides/libraries/writing-package-pages` |
`/tools/pub/writing-package-pages` |
| `/guides/google-apis` | `/resources/google-apis` |
| `/guides/language/coming-from/**` | `/resources/coming-from/**` |
@atsansone atsansone added the st.triage.ltw Indicates Lead Tech Writer has triaged label Jun 12, 2024
@parlough parlough added p2-medium Necessary but not urgent concern. Resolve when possible. and removed p3-low Valid but not urgent concern. Resolve when possible. Encourage upvote to surface. labels Nov 18, 2024
MaryaBelanger pushed a commit that referenced this issue Nov 18, 2024
MaryaBelanger pushed a commit that referenced this issue Nov 18, 2024
parlough added a commit that referenced this issue Dec 10, 2024
Not all of the content in the [Creating
packages](https://dart.dev/guides/libraries/create-packages) page
belongs in the pub docs, but that's where we include it now anyway. Some
of it is about libraries (imports, exports, conditional exports, etc.).
I'll create separate issues to solve that mix of concerns, but for now
this starts to clean up the `/guides` directory.

Contributes to #5767
parlough added a commit that referenced this issue Dec 10, 2024
parlough added a commit that referenced this issue Dec 10, 2024
Contributes to #5767

---------

Co-authored-by: Marya <111139605+MaryaBelanger@users.noreply.github.com>
parlough added a commit that referenced this issue Dec 16, 2024
- Move the sound-problems doc to the deprecated directory, as most of it
is duplicated with diagnostic message docs. See
#6265 for follow up work.
- Delete the `/guides/language` index as it's not linked to from
anywhere and mostly duplicates introductions from other pages.

Contributes to #5767
Contributes to #6265
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
a.language Relates to the Dart language tour e3-weeks Complete in < 4 weeks of normal, not dedicated, work infra.ia Relates to the organization of pages and structuring of content meta.umbrella Collects multiple related issues p2-medium Necessary but not urgent concern. Resolve when possible. st.triage.ltw Indicates Lead Tech Writer has triaged
Projects
None yet
Development

No branches or pull requests

2 participants