[wp-meta] [Making WordPress.org] #3972: Lack of clarity re: various documentation portals
Making WordPress.org
noreply at wordpress.org
Mon Dec 3 18:52:21 UTC 2018
#3972: Lack of clarity re: various documentation portals
-------------------------+-------------------------
Reporter: littlebizzy | Owner: (none)
Type: enhancement | Status: closed
Priority: normal | Milestone:
Component: Codex | Resolution: worksforme
Keywords: |
-------------------------+-------------------------
Comment (by DrewAPicture):
@littlebizzy After thinking about it a little bit, I recognize that I sort
of slammed the door in your face by closing the ticket here. Note: tickets
don't need to remain open for discussion to continue.
I recognize there can sometimes be a feeling of powerlessness when it
comes to decision-making on .org.
All of the people who are participating in the decision making for things
like docs or meta were users when they started and are still users today.
These are people who found something frustrating or broken or in need of
help and decided to pitch in to make them better. The decision-makers are
people who built up a reputation for consistently doing good work and have
thusly been rewarded with community trust.
None of the decisions currently driving docs team priorities on .org were
taken lightly; all of them were weighed and considered and discussed in
public spaces long before implementation began.
So while the basis of several of your points are valid, the shape of your
arguments lend a sense of aggressiveness that doesn't come across as
particularly constructive or useful at this stage in the process. Things
like renaming subdomains or completely overhauling the base approach are
pretty much non-starters. Could have, would have, should have. We devised
a roadmap and it's guided our approach pretty well so far.
Shutting off edit Codex at some point is a very real possibility and will
probably happen sooner than later now that HelpHub Phase I has been
launched. We were in a crunch to get it launched in time for WordPress 5.0
so Gutenberg user docs would have a place to live.
We could be better about making feedback mechanisms both more available
and transparent. If you're interesting in helping make that a reality,
we'd love to have you.
If I might give some advice to you as a new contributor in this space, it
would be to give greater consideration for how your arguments come across
going forward. We operate in the open here, and coloring arguments with
hyperbole – like reducing five years of work writing, editing, and
rewriting thousands of pages of docs – isn't going to advance positive
discussion forward.
It's OK to be frustrated, welcome to the club. We're all here to make
WordPress documentation better. There's ''always'' things and processes we
can improve, but it's a team effort.
--
Ticket URL: <https://meta.trac.wordpress.org/ticket/3972#comment:6>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org
More information about the wp-meta
mailing list