Comments (9)
Thanks for writing this up @inkblotty! Shipping an alpha React component was originally slated for Q4, but we've created an issue and added it as a Q3 stretch goal for our high-impact Primer React components epic.
from primer.style.
Thanks, @inkblotty!
I agree with @vdepizzol that in some instances this content is better suited to live in the same place as the pattern or component it relates to, as that's where folks will be to find out how to apply that component.
It would be great if we could have some reviews and edits before we publish this in primer.style/design as it's a departure from the way that the content is currently modelled. For example, some titles sound more like articles than more plain documentation that we have right now, so we'd need to make sure we understand the implication that has to the current content structure and if we need to make any changes.
from primer.style.
@yaili @vdepizzol -- We will absolutely get your reviews on these documents. I was hoping for them! Let me give a quick explanation of our driving philosophy for where things live right now.
You'll see references to Accessibility documentation in all areas of GitHub UI products. This issue lists just some of the places we've found documentation, and it also lists the different reasons we're using The Hub, our github/accessibility repo, and Primer. Our goal is to create a platform of Accessibility guidelines, easy to find, that anyone can use if they encounter these common patterns or need the resources we prepare.
From @vdepizzol:
Maybe we should consider that overlapping content could belong in different sections.
I fully anticipate we'd want to cross-link these docs from other areas, but we'd like one centralized place for the main content to live. We need it to be easier to prevent duplication or to prevent people not finding what's relevant to them.
From @vdepizzol:
@inkblotty do you think each of those bullet points would become their own page? Or could they be content sections of a page?
I think we're shooting for their own page right now so it's easier for us to point audit tickets to that page as a reference. That's the loose plan though. We can definitely combine sections that make sense. Could we talk about that case-by-case as we write and review?
from primer.style.
Of course! Sounds good. I'm always more than happy to help review documentation, so please ping me with anything you need!
from primer.style.
Hi 👋🏼 Can you provide more detail about why this would be needed? For example, what is the current proposed structure of the documentation? If it is that long, is primer.style the best place for it to live?
from primer.style.
I think we're going to be changing the primer.style sidebar navigation to use ActionList. If that's happening soon, we should wait until that work is done so we don't have to implement the collapsible behavior twice.
@yaili - let's link that issue here once it's created.
@vdepizzol - how do you feel about allowing ActionList to have collapsible groups?
from primer.style.
Hi @yaili -- we have these: [Epic]: Self-Serve Platform and [Tracking]: Self-Serve Platform. You can see there are some placeholder issues inside the Tracking issue, but some are also fleshed out. For Primer work, we'll just be extending the Accessibility section under the existing Interface Guidelines.
from primer.style.
@mperrotti The use of NavigationList
should support sub-groups. @siddharthkp has been experimenting with the use of ActionList
-- and I have just summarized some of the ideas in this issue:
However, the side navigation would become very long with all the documents we have planned.
@inkblotty do you think each of those bullet points would become their own page? Or could they be content sections of a page?
Maybe we should consider that overlapping content could belong in different sections. Per instance, "How to work with color" could be in the Foundation / Color page. Or, focus states could be under Foundation / Style.
The mock from the issue above has some ideas of some pages we're considering for Interface Guidelines -- I'm hoping to open an issue to keep track the navigation contents soon!
🙇
from primer.style.
Closing because NavList supports this
from primer.style.
Related Issues (20)
- Problems loading the site on Firefox HOT 1
- Add global search
- Add Presentations to Design dropdown in main nav HOT 1
- Primer.style homepage update: Release 1
- Primer.style homepage update: Release 2 HOT 3
- Primer.style homepage update: Release 3 HOT 1
- Primer.style hompepage update: Release 4 HOT 1
- Use Doctocat Header component HOT 1
- Move team data to Markdown/MDX
- Docked version of SideNav component? HOT 5
- Octicons-v2 webpage not found HOT 4
- Navigation Dropdowns not working on components page HOT 1
- Design and Development navbar dropdowns are broken on https://primer.style/components HOT 2
- Proposal: Rename master to main HOT 2
- Upgrade to Doctocat v2 HOT 1
- Primer.style website incident postmortem
- "Edit this page on GitHub" links broken HOT 2
- Latest react release version on the Primer.style is incorrect HOT 1
- `Build and deploy production` workflow fails on forks
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from primer.style.