-
Notifications
You must be signed in to change notification settings - Fork 141
/
topics.yaml
74 lines (74 loc) · 2.33 KB
/
topics.yaml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# Canonicalizing topics
# =====================
#
# Packages published to pub.dev can define `topics` in `pubspec.yaml`, see;
# https://dart.dev/tools/pub/pubspec#topics
#
# The list of topics is free-form, and package authors are expected to make up
# new topics as needed. Naturally, this will lead to duplicates and topics that
# only differ in spelling. For example, one package might use the topic "widget"
# while another package uses the topic "widgets".
#
# This file aims to mitigate duplicate topics by establishing _canonical topics_
# with descriptions and a list of aliases.
#
# Aliases for a topic will be resolved when the `pubspec.yaml` is parsed.
# Ensuring that a package tagged with the alias "widgets" will appear on pub.dev
# as if it had been tagged with the canonical topic "widget".
# Similarly, search queries will be normalized to canonical topics.
#
# Topic descriptions serve as documentation for next time an aliases is
# proposed. Descriptions can also be used in tooltips or topic listings:
# https://pub.dev/topics
#
#
# Canonical topic format
# ----------------------
#
# Entries in the `topics` list in this document, must have the form:
#
# ```yaml
# topics:
# - topic: <canonical-topic>
# description: <description for use in tooltips, documentation, etc>
# aliases:
# - <aliases-topic>
# - ...
# ```
#
#
# Contributing
# ------------
#
# You are welcome to submit pull-requests with additional aliases, canonical
# topics and/or improved topic descriptions.
#
# Please limit pull-requests to propose one topic per PR!
#
#
# Editorial guidelines
# --------------------
#
# The decision on whether or not to merge two similar topics can be difficult.
# When in doubt we should error on the side of caution and avoid merging topics.
# However, if mistakes are made these changes are reversible.
# And we should not be afraid of accepting that sometimes a single topic can
# have multiple meaning, even if this makes the topic hard to use.
#
# The editorial guidelines are intended to evolve as we gain more experience
# merging/managing topics.
topics:
- topic: widget
description: Packages that contain Flutter widgets.
aliases:
- widgets
- topic: logging
description: Packages for writing log messages.
aliases:
- logger
- logs
- log
- topic: testing
description: Packages that facilitate testing
aliases:
- test