Skip to content

Commit 8f9e82e

Browse files
authored
Move some content out of deprecated /guides directories (#5769)
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/**` |
1 parent c5ca81e commit 8f9e82e

15 files changed

+29
-23
lines changed

firebase.json

+6-1
Original file line numberDiff line numberDiff line change
@@ -194,8 +194,11 @@
194194

195195
{ "source": "/googleapis", "destination": "https://github.com/dart-lang/googleapis", "type": 301 },
196196
{ "source": "/guides/get-started", "destination": "/overview", "type": 301 },
197+
{ "source": "/guides/google-apis", "destination": "/resources/google-apis", "type": 301 },
197198
{ "source": "/guides/language/analysis-options", "destination": "/tools/analysis", "type": 301 },
198199
{ "source": "/guides/language/cheatsheet", "destination": "/language", "type": 301 },
200+
{ "source": "/guides/language/coming-from/js-to-dart", "destination": "/resources/coming-from/js-to-dart", "type": 301 },
201+
{ "source": "/guides/language/coming-from/swift-to-dart", "destination": "/resources/coming-from/swift-to-dart", "type": 301 },
199202
{ "source": "/guides/language/common-prob", "destination": "/guides/language/sound-problems", "type": 301 },
200203
{ "source": "/guides/language/concurrency", "destination": "/language/concurrency", "type": 301 },
201204
{ "source": "/guides/language/effective-dart", "destination": "/effective-dart", "type": 301 },
@@ -212,7 +215,9 @@
212215
{ "source": "/guides/libraries/futures-error-handling", "destination": "/libraries/async/futures-error-handling", "type": 301 },
213216
{ "source": "/guides/libraries/java-interop", "destination": "/interop/java-interop", "type": 301 },
214217
{ "source": "/guides/libraries/objective-c-interop", "destination": "/interop/objective-c-interop", "type": 301 },
215-
{ "source": "/guides/libraries/c-interop", "destination": "/interop/c-interop", "type": 301 },
218+
{ "source": "/guides/libraries/c-interop", "destination": "/interop/c-interop", "type": 301 },
219+
{ "source": "/guides/libraries/writing-package-pages", "destination": "/tools/pub/writing-package-pages", "type": 301 },
220+
{ "source": "/guides/libraries/useful-libraries", "destination": "/resources/useful-packages", "type": 301 },
216221
{ "source": "/guides/platforms", "destination": "/overview#platform", "type": 301 },
217222
{ "source": "/install", "destination": "/get-dart", "type": 301 },
218223
{ "source": "/install/**", "destination": "/get-dart", "type": 301 },

src/_data/side-nav.yml

+5-5
Original file line numberDiff line numberDiff line change
@@ -167,13 +167,13 @@
167167
- title: How to use packages
168168
permalink: /guides/packages
169169
- title: Commonly used packages
170-
permalink: /guides/libraries/useful-libraries
170+
permalink: /resources/useful-packages
171171
- title: Creating packages
172172
permalink: /guides/libraries/create-packages
173173
- title: Publishing packages
174174
permalink: /tools/pub/publishing
175175
- title: Writing package pages
176-
permalink: /guides/libraries/writing-package-pages
176+
permalink: /tools/pub/writing-package-pages
177177
- title: Package reference
178178
expanded: false
179179
children:
@@ -206,7 +206,7 @@
206206
- title: Number representation
207207
permalink: /guides/language/numbers
208208
- title: Google APIs
209-
permalink: /guides/google-apis
209+
permalink: /resources/google-apis
210210
- title: Multi-platform apps
211211
permalink: /multiplatform-apps
212212
- title: Command-line & server apps
@@ -365,9 +365,9 @@
365365
expanded: false
366366
children:
367367
- title: JavaScript to Dart
368-
permalink: /guides/language/coming-from/js-to-dart
368+
permalink: /resources/coming-from/js-to-dart
369369
- title: Swift to Dart
370-
permalink: /guides/language/coming-from/swift-to-dart
370+
permalink: /resources/coming-from/swift-to-dart
371371
- divider
372372
- title: FAQ
373373
permalink: /resources/faq

src/content/guides/whats-new.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -367,7 +367,7 @@ we made the following changes to this site:
367367
[community resources section]: /community#additional-community-resources
368368
[migration guide]: /null-safety/migration-guide
369369
[unsound null safety]: /null-safety/unsound-null-safety
370-
[Learning Dart as a Swift developer]: /guides/language/coming-from/swift-to-dart
370+
[Learning Dart as a Swift developer]: /resources/coming-from/swift-to-dart
371371
[booleans and equality operators]: /effective-dart/usage#dont-use-true-or-false-in-equality-operations
372372
[content-hashing]: /tools/pub/glossary#content-hashes
373373
[Zones]: /articles/archive/zones
@@ -381,7 +381,7 @@ we made the following changes to this site:
381381
[discussion]: /language/functions#parameters
382382
[Concurrency in Dart]: /language/concurrency
383383
[`pub global` page]: /tools/pub/cmd/pub-global
384-
[Learning Dart as a JavaScript developer]: /guides/language/coming-from/js-to-dart
384+
[Learning Dart as a JavaScript developer]: /resources/coming-from/js-to-dart
385385
[`dart run` page]: /tools/dart-run#debugging
386386
[operator precedence and associativity]: /language/operators
387387
[Building URIs]: /libraries/dart-core#building-uris
@@ -525,7 +525,7 @@ we made the following changes to this site:
525525
* Updated the [security][] page to match our current security practices.
526526
* Added a key binding (`/`) to automatically focus the search bar.
527527

528-
[Learning Dart as a JavaScript developer]: /guides/language/coming-from/js-to-dart
528+
[Learning Dart as a JavaScript developer]: /resources/coming-from/js-to-dart
529529

530530
[Named parameters]: /language/functions#named-parameters
531531
[Enumerated types]: /language/enums
@@ -716,7 +716,7 @@ we made the following changes to this site:
716716
[dart-tool]: /tools/dart-tool
717717
[recommended linter rules]: /tools/analysis#lints
718718
[core libraries]: /libraries
719-
[commonly used packages]: /guides/libraries/useful-libraries
719+
[commonly used packages]: /resources/useful-packages
720720
[dart.dev/jobs]: /jobs
721721
[no-promo]: /tools/non-promotion-reasons
722722
[`dart create`]: /tools/dart-create
@@ -794,9 +794,9 @@ we made the following changes to this site:
794794
[Numbers in Dart]: /guides/language/numbers
795795
[streams tutorial]: /tutorials/language/streams
796796
[typedef section]: /language/typedefs
797-
[Using Google APIs]: /guides/google-apis
797+
[Using Google APIs]: /resources/google-apis
798798
[Using Google Cloud]: /server/google-cloud
799-
[Writing package pages]: /guides/libraries/writing-package-pages
799+
[Writing package pages]: /tools/pub/writing-package-pages
800800

801801

802802
### Articles added to the Dart blog {:.no_toc}

src/content/libraries/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ working on collections of objects (`dart:collection`),
1919
making calculations (`dart:math`),
2020
and encoding/decoding data (`dart:convert`).
2121
Additional APIs are available in
22-
[commonly used packages](/guides/libraries/useful-libraries).
22+
[commonly used packages](/resources/useful-packages).
2323

2424
## Library tour
2525

src/content/overview.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -171,8 +171,8 @@ publish thousands of packages, with support for features like these:
171171

172172
To see a series of working examples featuring the Dart core libraries,
173173
read the [core library documentation](/libraries).
174-
To find additional APIs, see the
175-
[commonly used packages page](/guides/libraries/useful-libraries).
174+
To find additional APIs, check out the
175+
[commonly used packages page](/resources/useful-packages).
176176

177177

178178
## Dart: The platforms {:#platform}
File renamed without changes.

src/content/guides/libraries/useful-libraries.md src/content/resources/useful-packages.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: Commonly used packages
3-
description: Some of the most useful and popular packages, and where you can learn more.
3+
description: >-
4+
Some of the most useful and popular packages, and where you can learn more.
45
---
56

67
{% assign pub = site.pub %}

src/content/server/google-cloud.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ For information about creating HTTP servers with Dart, see the
1313

1414
For information about other Google APIs (including Firebase)
1515
that you might want to use from Dart code,
16-
see the [Google APIs page](/guides/google-apis).
16+
see the [Google APIs page](/resources/google-apis).
1717

1818
## Recommended solutions
1919

src/content/server/libraries.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -63,5 +63,5 @@ and [general-purpose packages][] such as `logging`:
6363

6464
{:.table .table-striped .nowrap}
6565

66-
[general-purpose packages]: /guides/libraries/useful-libraries#general-purpose-packages
66+
[general-purpose packages]: /resources/useful-packages#general-purpose-packages
6767
[gRPC]: https://grpc.io/

src/content/tools/pub/package-layout.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ is shown—rendered as [Markdown][]—on the page for your package.
122122
This is the perfect place to introduce people to your code.
123123

124124
For guidance on how to write a great README, see
125-
[Writing package pages](/guides/libraries/writing-package-pages).
125+
[Writing package pages](/tools/pub/writing-package-pages).
126126

127127
<a id="changelogmd"></a>
128128
## CHANGELOG.md {:#changelog}

src/content/tools/pub/publishing.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ The following files affect the contents of your package's web page.
8282
your package's web page.
8383
The file's contents should be marked up using [Markdown][].
8484
To learn how to write a great README, see
85-
[Writing package pages](/guides/libraries/writing-package-pages).
85+
[Writing package pages](/tools/pub/writing-package-pages).
8686

8787
**`CHANGELOG.md`**
8888
: If found, this file populates its own tab on your package's web page.

src/content/guides/libraries/writing-package-pages.md src/content/tools/pub/writing-package-pages.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -395,14 +395,14 @@ see these resources:
395395

396396
[README Checklist][]
397397
: A checklist for writing a README that
398-
helps readers feel confident about your project.
398+
helps readers feel confident about your project.
399399

400400
[Awesome README][]
401401
: A curated, annotated list of great READMEs.
402402

403403
[Make a README][]
404404
: An introduction to READMEs,
405-
with a template and suggestions for a good README.
405+
with a template and suggestions for a good README.
406406

407407
[How to write a great README for your GitHub project][]
408408
: Key elements of a good README, and a template.

src/content/tutorials/server/httpserver.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -35,5 +35,5 @@ Dart resources for writing HTTP servers include:
3535
[`shelf_router`]: {{site.pub-pkg}}/shelf_router
3636
[`shelf_static`]: {{site.pub-pkg}}/shelf_static
3737
[simple-sample]: {{site.repo.dart.org}}/samples/tree/main/server/simple
38-
[Using Google APIs]: /guides/google-apis
38+
[Using Google APIs]: /resources/google-apis
3939
[Using Google Cloud]: /server/google-cloud

0 commit comments

Comments
 (0)