docs(v2): add community pages (#2545)

* docs(v2): add community pages

* misc fixes
This commit is contained in:
Yangshun Tay 2020-04-06 01:10:22 +08:00 committed by GitHub
parent 8f0206b2fe
commit c1ef488115
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
5 changed files with 81 additions and 123 deletions

31
website/docs/support.md Normal file
View file

@ -0,0 +1,31 @@
---
id: support
title: Support
---
Docusaurus has a community of thousands of developers.
On this page we've listed some Docusaurus-related communities that you can be a part of; see the other pages in this section for additional online and in-person learning materials.
Before participating in Docusaurus' communities, [please read our Code of Conduct](https://engineering.fb.com/codeofconduct/). We have adopted the [Contributor Covenant](https://www.contributor-covenant.org/) and we expect that all community members adhere to the guidelines within.
## Stack Overflow
Stack Overflow is a popular forum to ask code-level questions or if you're stuck with a specific error. Read through the [existing questions](https://stackoverflow.com/questions/tagged/docusaurus) tagged with **docusaurus** or [ask your own](https://stackoverflow.com/questions/ask?tags=docusaurus)!
## Discussion forums
There are many online forums which are a great place for discussion about best practices and application architecture as well as the future of Docusaurus. If you have an answerable code-level question, Stack Overflow is usually a better fit.
- [Docusaurus online chat](https://discord.gg/docusaurus)
- [#docusaurus-2-dogfooding](https://discord.gg/7wjJ9yH) for user help
- [#docusaurus-2-dev](https://discord.gg/6g6ASPA) for contributing help
- [Reddit's Docusaurus community](https://www.reddit.com/r/docusaurus/)
## Feature requests
For new feature requests, you can create a post on our [Canny board](/feedback), which is a handy tool for roadmapping and allows for sorting by upvotes, which gives the core team a better indicator of what features are in high demand, as compared to GitHub issues which are harder to triage. Refrain from making a Pull Request for new features (especially large ones) as someone might already be working on it or will be part of our roadmap. Talk to us first!
## News
For the latest news about Docusaurus, [follow **@docusaurus** on Twitter](https://twitter.com/docusaurus) and the [official Docusaurus blog](/blog) on this website.

33
website/docs/team.md Normal file
View file

@ -0,0 +1,33 @@
---
id: team
title: Team
---
## Meet the Docusaurus Team
- Alexey Pyltsyn
- Fanny Batista Vieira
- Joel Marcey
- Yangshun Tay
## Honorary Alumni
- Endilie Yacop Sucipto
- Wei Gao
## Acknowledgements
React was originally created by Joel Marcey. Today, Docusaurus has a few hundred open source contributors. Wed like to recognize a few people who have made significant contributions to Docusaurus and its documentation in the past and have helped maintain them over the years:
- Amy Lam
- Cheng Lou
- Christine Abernathy
- Christopher Chedeau
- Elvis Wolcott
- Eric Nakagawa
- Fienny Angelina
- Frank Li
- Hector Ramos
- Ramón Lamana
- Ricky Vetter
- Sam Chou

View file

@ -112,7 +112,7 @@ module.exports = {
}, },
{to: 'blog', label: 'Blog', position: 'left'}, {to: 'blog', label: 'Blog', position: 'left'},
{to: 'showcase', label: 'Showcase', position: 'left'}, {to: 'showcase', label: 'Showcase', position: 'left'},
{to: 'feedback', label: 'Feedback', position: 'left'}, {to: 'docs/next/support', label: 'Community', position: 'left'},
{ {
to: 'versions', to: 'versions',
label: `v${versions[0]}`, label: `v${versions[0]}`,

View file

@ -7,12 +7,7 @@
module.exports = { module.exports = {
docs: { docs: {
Docusaurus: [ Docusaurus: ['introduction', 'design-principles', 'contributing'],
'introduction',
'design-principles',
'contributing',
'resources',
],
'Getting Started': ['installation', 'configuration'], 'Getting Started': ['installation', 'configuration'],
Guides: [ Guides: [
'creating-pages', 'creating-pages',
@ -35,4 +30,19 @@ module.exports = {
'theme-classic', 'theme-classic',
], ],
}, },
community: [
'support',
'team',
'resources',
{
type: 'link',
href: '/showcase',
label: 'Showcase',
},
{
type: 'link',
href: '/feedback',
label: 'Feedback',
},
],
}; };

View file

@ -1,116 +0,0 @@
/**
* Copyright (c) Facebook, Inc. and its affiliates.
*
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
*/
import React, {useEffect} from 'react';
import Layout from '@theme/Layout';
import Link from '@docusaurus/Link';
import useBaseUrl from '@docusaurus/useBaseUrl';
function Help() {
return (
<Layout permalink="/help" description="Docusaurus 2 Help page">
<div className="container margin-vert--xl">
<div className="text--center margin-bottom--xl">
<h1>Need Help?</h1>
<p>
If you need help with Docusaurus 2, you can try one of the
mechanisms below.
</p>
</div>
<div className="row">
<div className="col">
<h2>Browse the docs</h2>
<p>
Learn more about Docusaurus using the{' '}
<Link to={useBaseUrl('docs/introduction')}>
official documentation
</Link>
</p>
</div>
<div className="col">
<h2>Discord</h2>
<p>
You can join the conversation on{' '}
<a
target="_blank"
rel="noreferrer noopener"
href="https://discord.gg/docusaurus">
Discord
</a>{' '}
on one of our two text channels:{' '}
<a
target="_blank"
rel="noreferrer noopener"
href="https://discord.gg/7wjJ9yH">
#docusaurus-2-dogfooding
</a>{' '}
for user help and{' '}
<a
target="_blank"
rel="noreferrer noopener"
href="https://discord.gg/6g6ASPA">
#docusaurus-2-dev
</a>{' '}
for contributing help.
</p>
</div>
<div className="col">
<h2>Twitter</h2>
<p>
You can follow and contact us on{' '}
<a
target="_blank"
rel="noreferrer noopener"
href="https://twitter.com/docusaurus">
Twitter
</a>
.
</p>
</div>
<div className="col">
<h2>GitHub</h2>
<p>
At our{' '}
<a
target="_blank"
rel="noreferrer noopener"
href="https://github.com/facebook/docusaurus">
GitHub repo
</a>{' '}
Browse and submit{' '}
<a
target="_blank"
rel="noreferrer noopener"
href="https://github.com/facebook/docusaurus/issues">
issues
</a>{' '}
or{' '}
<a
target="_blank"
rel="noreferrer noopener"
href="https://github.com/facebook/docusaurus/pulls">
pull requests
</a>{' '}
for bugs you find or any new features you may want implemented. Be
sure to also check out our{' '}
<a
target="_blank"
rel="noreferrer noopener"
href="https://github.com/facebook/docusaurus/blob/master/CONTRIBUTING.md">
contributing guide
</a>
.
</p>
</div>
</div>
</div>
</Layout>
);
}
export default Help;