Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
tools [2023/07/06 11:32] – [Editing Publishing Testing] tabatkins | tools [2023/07/07 10:01] – [Meeting Tools] tabatkins |
---|
Tools particularly useful during (f2f or telcon) meetings: | Tools particularly useful during (f2f or telcon) meetings: |
* This DokuWiki (obviously) | * This DokuWiki (obviously) |
* To create an account, do (TO BE WRITTEN) | * To create an account, [[https://test.csswg.org/shepherd/register/|register on Shepherd]]. |
* To get that account permission to edit group pages, do (TO BE WRITTEN) | * To get that account permission to edit group pages, email plinss and/or fantasai |
* We use [[https://www.w3.org/Project/IRC/|the W3C's IRC server]] for backchannel communication and for minuting during meetings | * We use [[https://www.w3.org/Project/IRC/|the W3C's IRC server]] for backchannel communication and for minuting during meetings |
* We use multiple IRC bots: [[http://www.w3.org/2001/12/zakim-irc-bot|Zakim]], [[https://www.w3.org/2002/03/RRSAgent|RRSAgent]], [[https://github.com/dbaron/wgmeeting-github-ircbot/|github-bot]] | * We use multiple IRC bots: [[http://www.w3.org/2001/12/zakim-irc-bot|Zakim]], [[https://www.w3.org/2002/03/RRSAgent|RRSAgent]], [[https://github.com/dbaron/wgmeeting-github-ircbot/|github-bot]] |
* A [[https://bocoup.com/blog/how-to-scribe-at-tpac|blog post]] on some of the conventions we use on IRC, with a scribing focus | * [[tools:Scribing conventions]] |
| * A [[https://bocoup.com/blog/how-to-scribe-at-tpac|blog post]] on some of the conventions we use on IRC, with a scribing focus |
* [[https://log.csswg.org/irc.w3.org/css/today|IRC Logs]] are available for our IRC channels | * [[https://log.csswg.org/irc.w3.org/css/today|IRC Logs]] are available for our IRC channels |
* [[https://excalidraw.com/|Excalidraw]] and [[https://pad.w3.org/|W3C Etherpad]] in case you need a virtual whiteboard during a meeting. | * [[https://excalidraw.com/|Excalidraw]] and [[https://pad.w3.org/|W3C Etherpad]] in case you need a virtual whiteboard during a meeting. |
* in your [[https://www.w3.org/users/myprofile|w3c account]] go to “Connected accounts”, make sure your github account is linked | * in your [[https://www.w3.org/users/myprofile|w3c account]] go to “Connected accounts”, make sure your github account is linked |
* Get yourself invited to the w3c GitHub organization, and accept the invite. You can make your membership public if you want. This (plus the account linking above) should mean you’re automatically added to https://github.com/orgs/w3c/teams/w3c-group-100-members/members . The invite should be doable by any W3C staff. (TODO: Is this step still needed?) | * Get yourself invited to the w3c GitHub organization, and accept the invite. You can make your membership public if you want. This (plus the account linking above) should mean you’re automatically added to https://github.com/orgs/w3c/teams/w3c-group-100-members/members . The invite should be doable by any W3C staff. (TODO: Is this step still needed?) |
* [[tools:git|Git/GitHub]] or [[tools:hg|Mercurial]] can be used to access the version control system for our [[spec|specs]] and our [[test|tests]]. (Mercurial access is deprecated; the bidirectional mirroring may no longer be running.) | * Spec sources are maintained on [[tools:git|Git/GitHub]]. |
* [[http://www.w3.org/Mail/|W3C Mailing Lists]]: specifically | * [[http://www.w3.org/Mail/|W3C Mailing Lists]]: specifically |
* [[tools:www-style|www-style]] for our specs, | * [[tools:www-style|www-style]] for **all** CSS spec-related discussion, |
* [[http://lists.w3.org/Archives/Public/public-css-testsuite/|public-css-testsuite]] for testing, and | |
* [[http://lists.w3.org/Archives/Public/public-fx/|public-fx]] for specs we co-edit with the [[http://www.w3.org/Graphics/SVG/|SVGWG]]. | * [[http://lists.w3.org/Archives/Public/public-fx/|public-fx]] for specs we co-edit with the [[http://www.w3.org/Graphics/SVG/|SVGWG]]. |
* We also have an [[http://lists.w3.org/Archives/Member/w3c-css-wg/|internal list]] for administrivia. | * The [[http://lists.w3.org/Archives/Member/w3c-css-wg/|CSSWG private list]] for administrivia **only**, no spec discussions occur here. |
| |
===== Editing Publishing Testing ===== | ===== Editing Publishing Testing ===== |
* Specs are written in [[https://speced.github.io/bikeshed|Bikeshed]] ([[https://speced.github.io/bikeshed/#install-normal|install instructions]], or use [[https://speced.github.io/bikeshed/#remote|curl or the web form]]. | * Specs are written in [[https://speced.github.io/bikeshed|Bikeshed]] ([[https://speced.github.io/bikeshed/#install-normal|install instructions]], or use [[https://speced.github.io/bikeshed/#remote|curl or the web form]]) |
* A fresh spec should be started from the [[https://drafts.csswg.org/css-module-bikeshed/Overview.bs|module template]]. | * A fresh spec should be started from the [[https://drafts.csswg.org/css-module-bikeshed/Overview.bs|module template]]. |
* Bibliographic data is sourced from [[https://www.specref.org/|SpecRef]], which is automatically loaded into Bikeshed. See [[tools:spec-processor]] for tips. | * Bibliographic data is sourced from [[https://www.specref.org/|SpecRef]], which is automatically loaded into Bikeshed. |
* Note: A few very old specs specs still use | * Note: A few very old specs specs still use |
* [[https://www.w3.org/Style/Group/css3-src/bin/postprocess|Bert's post-processor]] | * [[https://www.w3.org/Style/Group/css3-src/bin/postprocess|Bert's post-processor]] |
* the older [[http://dev.w3.org/csswg/css-module/Overview.src.html|module template]] | * the older [[http://dev.w3.org/csswg/css-module/Overview.src.html|module template]] |
| * See [[tools:spec-processor]] for tips. |
* Ask Tab, fantasai, or ChrisL for help if you need to edit these. | * Ask Tab, fantasai, or ChrisL for help if you need to edit these. |
* [[https://www.w3.org/blog/CSS/wp-admin/|WordPress login]] for our [[http://www.w3.org/blog/CSS/|official blog]] | * [[https://www.w3.org/blog/CSS/wp-admin/|WordPress login]] for our [[http://www.w3.org/blog/CSS/|official blog]] |