Re: Community docathon in Halifax?
If anyone has semi-formed ideas on how we can better organize ASF or ComDev documentation, please add them here or as a child page, so we can be semi-organized about documenting our documentation change ideas. 8-) https://cwiki.apache.org/confluence/display/COMDEV/Proposal%3A+ComDev+Website+Improvements Plenty of these ideas deal with different areas and responsibilities, so some will need coordination elsewhere to really make architecture changes - but it feels like we have the energy to do it! -- - Shane ComDev PMC The Apache Software Foundation - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
[PR] Add tag (comdev-site)
rbowen opened a new pull request, #131: URL: https://github.com/apache/comdev-site/pull/131 (no comment) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
Re: [PR] Add tag (comdev-site)
rbowen merged PR #131: URL: https://github.com/apache/comdev-site/pull/131 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
Re: Community docathon in Halifax?
On Thu, 2023-10-05 at 23:37 -0400, Shane Curcuru wrote: > A number of us have been working on some very specific community > documentation improvements over the past year, and it would be great > to > find time in Halifax to share ideas and energize each other. Who's > going to be there, when might you want to work on this, and what are > your ideas? I'll be attending some of the Sustainability track today, but I'll mostly be hanging out wherever I can find an outlet and hacking on the ComDev website. What I would like to do is discuss how to * Consolidate duplicate pages that have grown organically over the past 10 years * Organize the site into clearly audience-centric areas * Identify docs that still need to be written * Identify overlap with other ASF sites, and figure out where the *best* place is for that particular content. > > Besides all sorts of editing pages to really focus on writing for the > average reader (often newcomers on community.a.o pages), I really > wonder > about holistic improvements to information architecture, especially > ones > that normalize and canonicalize all the processes around the ASF way. > Rich and others have already started great contributor ladder stuff, > and > also eliminating or consolidating duplicate pages. > > One issue I struggle with strategically is: where should different > content live? On one hand, we want to focus on the reader, and meet > them with what they need. On the other hand, we have various > communities/officers inside the ASF who either set policy, or perhaps > just provide advice and best practices. Where should different > policies > - and documentation thereof - live? > > I think we need to strive towards documentation bits that can be > repurposed, or can otherwise serve both as an intro to a whole > process, > as well as a more detailed "why" that process came to be. > > I also think organizationally, we need to decide what lives where and > make it easier to keep updated. It often feels like core policies > and > strict requirements primarily need to live on /dev (or /legal, > /foundation/trademarks, infra.a.o, etc.), but that they should be > shorter, clearer, and more direct about exactly what their policies > are. > > And then much of the why content, and content that helps draw > newcomers > into thinking about the bigger picture, should primarily live on > community.a.o. If people are curious or want to learn about how we > *think* about communities, come to ComDev. But if existing committers > just want to know how to vote on a release, go to the appropriate and > simple /dev page that just describes the process. > > I'll be in Halifax thru Wednesday lunchtime, but will mostly be > speaking > and thinking about sustainability all Sunday - including at a > Sustainability BOF in the evening.= > - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
[PR] A variety of small changes (comdev-site)
rbowen opened a new pull request, #132: URL: https://github.com/apache/comdev-site/pull/132 A variety of small tweaks, in advance of the DocHack at Community over Code Halifax -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
Re: [PR] A variety of small changes (comdev-site)
rbowen merged PR #132: URL: https://github.com/apache/comdev-site/pull/132 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
[website] Jenkins job Community Development/site/main#72 failed
There is a build failure in Community Development/site/main. Build: https://ci-builds.apache.org/job/Community%20Development/job/site/job/main/72/ - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
[website] Jenkins job Community Development/site/main#73 back to normal
The build for Community Development/site/main completed successfully and is back to normal. Build: https://ci-builds.apache.org/job/Community%20Development/job/site/job/main/73/ - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
[PR] Move gettingStarted into newcomers audience (comdev-site)
rbowen opened a new pull request, #133: URL: https://github.com/apache/comdev-site/pull/133 As discussed on dev@community, move into an audience-focused model - thus, 'getting started' is now a doc in the newcomers directory, rather than a single file in a separate directory. Redirects old URLs. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
Re: [PR] Move gettingStarted into newcomers audience (comdev-site)
rbowen merged PR #133: URL: https://github.com/apache/comdev-site/pull/133 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
[events-website] Jenkins job Community Development/events-site/main#90 back to normal
The build for Community Development/events-site/main completed successfully and is back to normal. Build: https://ci-builds.apache.org/job/Community%20Development/job/events-site/job/main/90/ - To unsubscribe, e-mail: dev-unsubscr...@community.apache.org For additional commands, e-mail: dev-h...@community.apache.org
