Early proposal for a Gnome 43 hackfest

2022-02-26 Thread Shaun McCance
While it's fresh in my brain: I don't think the Gnome 43 schedule is available yet, but based on my understanding of how time works, we should hit the freeze in mid-August. That's generally the best timing for a docs hackfest. Devconf.us is planned for August 18-20 in Boston. I think we could

Docs office hours Feb 22

2022-02-21 Thread Shaun McCance
Hi all, I'll host a docs office hours next Tuesday, February 22 at 17:00 UTC. Get your local time: date -d "2022-02-22 17:00 UTC" We'll meet on meet.gnome.org: https://meet.gnome.org/sha-muk-akl-apm GNOME 42 has just feature freeze, which means docs work can really ramp up. Here's the

Re: Possible remote docs hacking - 2/25 - 2/27

2022-02-19 Thread Shaun McCance
Do y'all want to have video running on meet.gnome.org, or would you rather just use chat? I can commit to being in front of my computer from 1200 to 1500 UTC-5 on Saturday and Sunday, with varying availability otherwise. On Sat, 2022-02-19 at 07:44 -0500, Michael Hill via gnome-doc-list wrote: >

Docs office hours Feb 15

2022-02-14 Thread Shaun McCance
Hi all, I'll host a docs office hours next Tuesday, February 15 at 17:00 UTC. Get your local time: date -d "2022-02-15 17:00 UTC" We'll meet on meet.gnome.org: https://meet.gnome.org/sha-muk-akl-apm GNOME 42 has just entered feature freeze, which means docs work can really ramp up. Here's

Docs office hours Feb 8

2022-02-07 Thread Shaun McCance
Hi all, I'll host a docs office hours next Tuesday, February 8 at 17:00 UTC. Get your local time: date -d "2022-02-08 17:00 UTC" We'll meet on meet.gnome.org: https://meet.gnome.org/sha-muk-akl-apm Here's the working draft of the work plan:

Re: yelp-check validate noise

2022-02-02 Thread Shaun McCance
On Tue, 2022-02-01 at 23:02 +0100, Gunnar Hjalmarsson wrote: > Hi! > > Lately, when running "yelp-check validate", the output includes > things > which smell false positives. Example: > > gnome-help/C$ yelp-check validate --strict \ >  > --allow http://www.w3.org/2005/11/its \ >  > --allow

No office hours Feb 1

2022-01-31 Thread Shaun McCance
I've got an all-day work meeting tomorrow, so I have to cancel this week's docs office hours. I plan to do office hours again next week on February 8. You can still do work without me. Here's the draft work plan: https://gitlab.gnome.org/Teams/documentation/initiatives/-/issues/14 Thanks, Shaun

Re: Docs office hours Jan 25

2022-01-25 Thread Shaun McCance
-1643130075597 On Mon, 2022-01-24 at 11:28 -0500, Shaun McCance wrote: > Hi all, > > I'll host a docs office hours next Tuesday, January 25 at 17:00 UTC. > Get your local time: > >     date -d "2022-01-25 17:00 UTC" > > We'll meet on meet.gnome.org: > > https://meet.

Docs office hours Jan 25

2022-01-24 Thread Shaun McCance
Hi all, I'll host a docs office hours next Tuesday, January 25 at 17:00 UTC. Get your local time: date -d "2022-01-25 17:00 UTC" We'll meet on meet.gnome.org: https://meet.gnome.org/sha-muk-akl-apm Last week, I had some urgent dayjob work that kept me from progressing on the GNOME 42 work

Docs office hours Jan 18

2022-01-14 Thread Shaun McCance
Hi all, I'll host a docs office hours next Tuesday, January 18 at 17:00 UTC. Get your local time: date -d "2022-01-18 17:00 UTC" We'll meet on meet.gnome.org: https://meet.gnome.org/sha-muk-akl-apm This Tuesday, I will be finishing the documentation work plan I started for GNOME 42 and

(incomplete) work plan for 42

2022-01-11 Thread Shaun McCance
In today's office hours, I started a docs work plan for Gnome 42: https://gitlab.gnome.org/Teams/documentation/initiatives/-/issues/14 This is incomplete, but it has the basic structure. Feel free to ask questions or start working on stuff. I also landed some fixes in Yelp that will help with

Bringing office hours back

2022-01-06 Thread Shaun McCance
Hi all, I'm bringing docs office hours back for the new year. Weekly on Tuesdays at 17:00 UTC, starting January 11. Get your local time: date -d "2022-01-11 17:00 UTC" We'll meet on meet.gnome.org: https://meet.gnome.org/sha-muk-akl-apm This Tuesday, I will be focused on writing up a

Re: Status of help.gnome.org and Pintail

2021-11-09 Thread Shaun McCance
On Tue, 2021-09-28 at 22:02 +0100, Emmanuele Bassi via gnome-doc-list wrote: > A few things I found out while playing with this, today: > > - pintail is not really blazing fast, taking 15 minutes to build the > site for the default C locale; but once translations are thrown in > the mix it gets

Re: Revamping gnome-help style

2021-07-19 Thread Shaun McCance
On Wed, 2021-06-30 at 23:25 +0200, Gunnar Hjalmarsson wrote: > But on Ubuntu there is another related problem: We have the > additional > group "Install & remove software", but no related tile image. Is > there > an extended collection of tile-*.svg images somewhere from where I > could > pick

Change help IDs to reverse DNS style?

2021-06-30 Thread Shaun McCance
Hi folks, Over the last few years, we've moved all sorts of identifiers to the reverse DNS style, like org.gnome.Calculator. Using that one app as an example, there's: * org.gnome.Calculator.desktop * org.gnome.Calculator.appdata * org.gnome.Calculator.gschema * org.gnome.Calculator.svg *

Re: Revamping gnome-help style

2021-06-30 Thread Shaun McCance
or runtime dependency. > > But then I noticed this: > > On 2021-02-10 21:30, Shaun McCance wrote: > > * Use a new experimental icon tile presentation for the front page > > of > > gnome-help (and possibly other prominent guide pages). I've named > > the > &g

Status of help.gnome.org and Pintail

2021-05-26 Thread Shaun McCance
Folks, I've been off-and-on working on retooling help.gnome.org using Pintail, the documentation publishing platform built for Mallard and Ducktype. I'd like to get this finally finished. I could use help. Here is a current preview: https://people.gnome.org/~shaunm/help.gnome.org/ Here is the

Mallard transforms with JavaScript?

2021-05-16 Thread Shaun McCance
Hi all, I posted this to my blog and Twitter, but I figured it would be good to post here as well. (I'm posting the same thing to mallard-list.) A few weeks ago, I got the crazy idea to try to do documentation transforms in JavaScript with mustache templates. Right now, all our transforms are in

Re: Google Summer of Docs proposal 2021

2021-03-16 Thread Shaun McCance
On Mon, 2021-03-15 at 08:11 -0700, Sriram Ramkrishna wrote: > Hey folks! > > I'm working on a GSoD for this year and I've outlined the proposal. I > just wanted to give you all a heads up. I'm mostly focusing on our > wiki and looking to remove everything updated, and update the ones > that are

Fwd: GNOME Chat Platforms Evaluation Survey

2021-03-04 Thread Shaun McCance
Docs friends, If you have opinions about where we chat, please fill out this survey. Thanks, Shaun Forwarded Message From: Kristi Progri To: foundation-annou...@gnome.org, foundation-l...@gnome.org Subject: GNOME Chat Platforms Evaluation Survey Date: Thu, 4 Mar 2021 13:05:03

Revamping gnome-help style

2021-02-10 Thread Shaun McCance
Hi all, I've been working on some style revamps for gnome-help for GNOME 40. It started with just getting rid of desc links, but it grew into a whole thing. Please take a look at this WIP MR: https://gitlab.gnome.org/GNOME/gnome-user-docs/-/merge_requests/102 Current things I'm looking at: *

Re: Chat Evaluation Feedback

2021-02-10 Thread Shaun McCance
On Mon, 2021-02-08 at 13:05 +0100, Kristi Progri wrote: > Hi Documentation team, > I hope you are all doing well. > > Our latest initiative - the Chat Evaluation - needs your feedback.   > As you may be aware, we are in the process of evaluating the > different chat platforms used by the members

No docs standup today, Dec 8

2020-12-08 Thread Shaun McCance
Hi folks, Today's docs standup totally fell off my radar. Sorry about that. Let's cancel for today and do it again next week. -- Shaun ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Docs standup tomorrow, Dec 1

2020-11-30 Thread Shaun McCance
Hi all, It's time for another weekly docs standup. The next one is tomorrow, December 1, at 16:00 UTC. https://meet.gnome.org/b/sha-muk-akl-apm If you can't make it, no worries, we'll do it again next week. And don't feel like you have to commit to the whole time. If you just want to pop in for

No docs standup tomorrow, Nov 24

2020-11-23 Thread Shaun McCance
Folks, This is a holiday week in the US, and I'm taking some time off to recharge. So, no docs standup this week (unless someone else wants to run one). See you next week. -- Shaun ___ gnome-doc-list mailing list gnome-doc-list@gnome.org

Docs standup tomorrow, Nov 17

2020-11-16 Thread Shaun McCance
Hi all, It's time for another weekly docs standup. The next one is tomorrow, November 17, at 16:00 UTC. https://meet.gnome.org/b/sha-muk-akl-apm If you can't make it, no worries, we'll do it again next week. And don't feel like you have to commit to the whole time. If you just want to pop in

Docs standup tomorrow, Nov 10

2020-11-09 Thread Shaun McCance
Hi all, It's time for another weekly docs standup. The next one is tomorrow, November 10, at 16:00 UTC. https://meet.gnome.org/b/sha-muk-akl-apm NOTE the UTC time is now 16:00 due to DST ending in the US. If you can't make it, no worries, we'll do it again next week. And don't feel like you

No docs standup tomorrow, Nov 3

2020-11-02 Thread Shaun McCance
Hi folks, I'm canceling the docs standup for tomorrow. It's election day in the US, and many of us will be working thru anxiety. I'll be back on next week. Take care and be well. -- Shaun ___ gnome-doc-list mailing list gnome-doc-list@gnome.org

Re: Proposal to change how we record versions

2020-10-29 Thread Shaun McCance
Hi folks, I filed this as an issue in our new Initiatives space on GitLab: https://gitlab.gnome.org/Teams/documentation/initiatives/-/issues/7 On Wed, 2020-09-16 at 14:17 -0400, Shaun McCance wrote: > Hi all, > > GNOME is changing its versioning scheme. The next major GNOM

Docs standup tomorrow, Oct 27

2020-10-26 Thread Shaun McCance
Hi all, It's time for another weekly docs standup. The next one is tomorrow, October 27, at 15:00 UTC. https://meet.gnome.org/b/sha-muk-akl-apm NOTE Europe just ended DST, but the US ends DST at the end of the week. At this time, we're following my clock. European friends, that means this

Team space on GitLab

2020-10-23 Thread Shaun McCance
Hi all, I requested a space for the docs team on GitLab. Here it is: https://gitlab.gnome.org/Teams/documentation And here's where to track larger initiatives across multiple docs: https://gitlab.gnome.org/Teams/documentation/initiatives/-/issues Thanks, Shaun

Cleaning up our wiki

2020-10-20 Thread Shaun McCance
Today during the standup, I started an audit of the DocumentionProject wiki space on wiki.gnome.org. There's a bunch of old stuff in there, and it's confusing to people trying to join. I immediately had the issue of where to do the audit. If I put it in the wiki, then I'd be adding to the cruft

Docs standup tomorrow, Oct 20

2020-10-19 Thread Shaun McCance
Hi all, I'm going to try to stick to this commitment to do weekly docs standups. The next one is tomorrow, October 20, at 15:00 UTC. https://meet.gnome.org/b/sha-muk-akl-apm If you can't make it, no worries, we'll do it again next week. And don't feel like you have to commit to an hour. If you

Re: Status of gnome-getting-started-docs

2020-10-13 Thread Shaun McCance
On Wed, 2020-10-07 at 16:07 +0200, Gunnar Hjalmarsson wrote: > Hi! > > I see no 3.38 release of gnome-getting-started-docs. Should it be > considered obsolete? > > I'm asking because so far we have shipped gnome-getting-started-docs > by > default in Ubuntu. Maybe it's time to stop doing so.

Docs standup today

2020-10-13 Thread Shaun McCance
Hi all, This is a reminder that I'll host our first-in-a-long-time docs standup today at 15:00 UTC. (That's in about one hour from when I'm typing this email.) We'll meet here: https://meet.gnome.org/b/sha-muk-akl-apm If you can't make it, no worries, we'll do it again next week. Everybody is

Re: Weekly docs standups

2020-10-09 Thread Shaun McCance
oup. There > are a number of folks who are interested in documentation and this > will give them a chance to ask questions or ask some onboarding type > questions. I hope that is ok - just wanted to check with y'all first. > sri > > > On Thu, Oct 8, 2020 at 8:51 AM Shaun McCa

Weekly docs standups

2020-10-08 Thread Shaun McCance
Hi all, I've brought up the idea of regular meetings in the past. I think the best way to make them happen is to just do them. So, I'm going to start doing a weekly standup every Tuesday at 11:00 US/Eastern. That's 15:00 UTC right now, but I'm going to follow US DST. I chose this time because it

Proposal to change how we record versions

2020-09-16 Thread Shaun McCance
Hi all, GNOME is changing its versioning scheme. The next major GNOME release will be GNOME 40: https://discourse.gnome.org/t/new-gnome-versioning-scheme/4235 This is a good opportunity for us to change how we record versions in Mallard revision elements. Mallard provides three attributes to

Re: Season of Docs Acceptance

2020-08-31 Thread Shaun McCance
On Wed, 2020-08-19 at 01:09 +0530, Pranali Deshmukh via gnome-doc-list wrote: > @Petr Kovar, @sha...@gnome.org Can you please let me know a suitable > time to have a quick call / IRC meeting to go through my Project > Roadmap Plan for the program so that I can get started with the > program work

Re: Converting yelp-check to Python

2020-06-22 Thread Shaun McCance
let me know. > On Sat, Jun 13, 2020 at 2:01 PM Shaun McCance > wrote: > > Hi all, > > > > Over the last couple weekends, I've been working on converting > > yelp- > > check to Python. I've basically hit feature parity (with caveats), > > and > >

Converting yelp-check to Python

2020-06-13 Thread Shaun McCance
Hi all, Over the last couple weekends, I've been working on converting yelp- check to Python. I've basically hit feature parity (with caveats), and it's now in git. It hasn't yet replaced yelp-check, but you can test it, and I'd appreciate if you did. First, grab from git: git clone

Re: including system icons in help docs

2020-05-08 Thread Shaun McCance
On Thu, 2020-04-30 at 11:03 +1000, Michael Gratton wrote: > Hi all, > > Is it possible to include system icons in Yelp docs without shipping > a > copy of them? > > Per[0], Geary's help manual needs to refer to accessing a secondary > menu button, but that doesn't have a text label in the UI,

Let's start talking

2020-05-08 Thread Shaun McCance
Hi all, I miss seeing you all and getting great docs work done. Email and IRC feel stagnant these days. I propose we start having weekly video calls to triage issues, discuss plans, and just be social. Who's interested? -- Shaun ___ gnome-doc-list

Re: [FYI] "ApplicationHelp" on GNOME wiki pretty much up-to-date

2020-02-10 Thread Shaun McCance
On Sat, 2020-02-08 at 19:41 +0100, Andre Klapper wrote: > Hi everyone, > > as a side effect of updating some docs in random apps over the last > weeks, I also checked the state of docs for most apps and updated > https://wiki.gnome.org/DocumentationProject/Tasks/ApplicationHelp > > Hence that

Docs status tracker

2020-01-13 Thread Shaun McCance
Hi all, I put together a thing over the weekend to show the status of docs on some web pages. My fellow old farts will probably remember I've done this multiple times in the past. "But this time, I mean it!" I tried to keep this super simple so it could be easily deployed. Here's the code:

Re: Doc team notifications of freeze breaks

2019-09-11 Thread Shaun McCance
On Mon, 2019-09-09 at 08:57 -0500, mcatanz...@gnome.org wrote: > On Fri, Sep 6, 2019 at 3:47 PM, mcatanz...@gnome.org wrote: > > If there are any recent examples of a documentation change being > > committed within the freeze window in response to a freeze break > > notification, please let me

Re: Doc team notifications of freeze breaks

2019-09-09 Thread Shaun McCance
On Fri, 2019-09-06 at 15:47 -0500, mcatanz...@gnome.org wrote: > Hi, > > Historically, our rules for freezes have required notifying > gnome-doc-list@ of any freeze breaks. This rule has not always been > followed (I'm a flagrant violator myself). Since nowadays > documentation > operates on a

Re: yelp-build misses .stack file

2019-06-12 Thread Shaun McCance
On Wed, 2019-06-12 at 19:19 +0200, Gunnar Hjalmarsson wrote: > On 2019-06-12 19:10, Shaun McCance wrote: > > On Wed, 2019-06-12 at 16:23 +0200, Gunnar Hjalmarsson wrote: > > > When using yelp-build to convert Mallard files to HTML, this > > > message > > > sh

Re: yelp-build misses .stack file

2019-06-12 Thread Shaun McCance
On Wed, 2019-06-12 at 16:23 +0200, Gunnar Hjalmarsson wrote: > When using yelp-build to convert Mallard files to HTML, this message > shows up: > > warning: failed to load external entity "file://.../gnome- > help/%2A.stack" > > Wondering if someone possibly can explain what it means and/or

[yelp-xsl] Created branch gnome-3-32

2019-03-16 Thread Shaun McCance
The branch 'gnome-3-32' was created pointing to: 87dc85f... Version 3.32.1 ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Revisiting the utility of branch notifications

2019-03-14 Thread Shaun McCance
Sit back and let Uncle Shaun tell you a story. A long time ago, GNOME releases just kind of happened, and docs either happened with them or they didn't. Usually they didn't. Then we implemented release schedules with freezes. That helped the docs team a lot. We were able to start documenting as of

Re: Google Season of Docs

2019-03-14 Thread Shaun McCance
On Wed, 2019-03-13 at 10:03 -0400, Shaun McCance wrote: > Google has announced Season of Docs, like Summer of Code, but for > docs. > I'm still reading up on the details. > > https://developers.google.com/season-of-docs/ This conversation also seems to be happening on Di

Re: Discourse for GNOME docs

2019-03-14 Thread Shaun McCance
On Sun, 2019-03-10 at 19:44 +0100, Petr Kovar wrote: > On Sun, 03 Mar 2019 17:25:38 -0500 > Shaun McCance wrote: > > > Hi all, > > > > We have a Discourse server for GNOME now: > > > > https://discourse.gnome.org/ > > > > Ther

Google Season of Docs

2019-03-13 Thread Shaun McCance
Google has announced Season of Docs, like Summer of Code, but for docs. I'm still reading up on the details. https://developers.google.com/season-of-docs/ -- Shaun ___ gnome-doc-list mailing list gnome-doc-list@gnome.org

Discourse for GNOME docs

2019-03-03 Thread Shaun McCance
Hi all, We have a Discourse server for GNOME now: https://discourse.gnome.org/ There's been some conversation about moving development conversations there. I honestly don't know how that will pan out, but it's something we ought to think about for docs conversations. One of the advantages over

Deprecating the Mallard mime attribute

2019-01-07 Thread Shaun McCance
For those of you not on mallard-list, I wanted to let you know about a deprecation in the upcoming Mallard 1.1. In Mallard 1.0, you mark the content type of a code block with the mime attribute. In Mallard 1.1, the mime attribute will be deprecated in favor of the simpler type attribute, which

Developer Center Hackfest

2018-07-26 Thread Shaun McCance
In the developer center call today, we talked about a hackfest. This is last minute, but I'd be remiss not to mention it. Next month is Write the Docs Cincinnati, coupled with the Open Help Sprints. http://www.writethedocs.org/conf/cincinnati/2018/ You get two days of great docs talks and

[yelp-xsl] Created branch gnome-3-28

2018-05-27 Thread Shaun McCance
The branch 'gnome-3-28' was created pointing to: a90bb7c... Version 3.28.0 ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Write the Docs + Open Help

2018-05-06 Thread Shaun McCance
Hello friends, The GNOME docs team has come out to Open Help and held a sprint almost every year it's been held. This year, Open Help is teaming up with Write the Docs to produce Write the Docs + Open Help Cincinnati 2018: http://www.writethedocs.org/conf/cincinnati/2018/ Similar to Open Help,

Re: gnome-user-docs and gnome-getting-started-docs migrated to GitLab

2018-03-28 Thread Shaun McCance
On Wed, 2018-03-28 at 16:29 +0200, Gunnar Hjalmarsson wrote: > On 2018-03-28 15:53, Petr Kovar wrote: > > On Wed, 28 Mar 2018 15:47:39 +0200 > > > Where are the release tarballs made available now? > > > > Nothing has changed in the way we release and deliver tarballs. > > This > > migration is

Re: Install link follow-up

2018-03-22 Thread Shaun McCance
On Thu, 2018-03-22 at 16:03 +0100, Gunnar Hjalmarsson wrote: > In the thread "Latest changes in gnome-user-docs" I mentioned that > the > install links of the type 'action="install:"' don't work on > Ubuntu. Want to mention that we found a convenient way to convert > those > links for now when

Re: HTML build: Howto append language to internal link URLs

2018-02-20 Thread Shaun McCance
On Tue, 2018-02-20 at 16:58 +0100, Gunnar Hjalmarsson wrote: > On 2018-02-20 16:10, Shaun McCance wrote: > > > Are this kind of available parameters documented anywhere? > > > > Right here: > > > > http://yelp.io/xsl/parameters.html > > > > Ev

Re: HTML build: Howto append language to internal link URLs

2018-02-20 Thread Shaun McCance
On Sat, 2018-02-17 at 16:15 +0100, Gunnar Hjalmarsson wrote: > On 2018-02-16 09:58, Frederic Peters wrote: > > library-web adjust some parameters; this change comes from: > > > > > select="concat('.html.',$libgo.lang)"/> > > > > ($libgo.lang contains the language being generated) > > > >

Re: [evolution-ews] Two new translatable strings added for 3.27.91

2018-02-09 Thread Shaun McCance
On Wed, 2018-02-07 at 23:33 +0100, Alexandre Franke wrote: > On Wed, Feb 7, 2018 at 7:15 PM, Milan Crha wrote: > > > > The strings in question are: > >Tenant cannot be empty > > That one probably deserves a translator comment. I know the word > tenant in the context of

Re: Migrate to gitlab.gnome.org?

2018-01-12 Thread Shaun McCance
+100 on the migration. I think the team might want to have a conversation about to what extent we want to do merge requests versus committing directly. I also think our opinion on that will evolve over time. So, you know, don't get too hung up on it. -- Shaun On Thu, 2018-01-11 at 19:51 +0100,

Re: Conditions not satisfied when converting to HTML

2017-12-20 Thread Shaun McCance
On vacation with only my phone, so sorry for the crap email. I'll look more closely when I get home. By default, yelp-build doesn't set any platform: tokens. You can set them with a param in the customization stylesheet you pass with -x. In general, if a page is useless without tokens set, it's

Re: Example Ducktype conversion of gnome-help

2017-10-25 Thread Shaun McCance
On Mon, 2017-10-23 at 23:46 +0200, Petr Kovar wrote: > On Mon, 23 Oct 2017 11:07:07 -0400 > Shaun McCance <sha...@gnome.org> wrote: > > > On Sun, 2017-10-22 at 22:10 -0400, Jeremy Bicha wrote: > > > On Sun, Oct 22, 2017 at 3:10 PM, Shaun McCance <sha...@gnom

Re: Example Ducktype conversion of gnome-help

2017-10-23 Thread Shaun McCance
On Sun, 2017-10-22 at 22:10 -0400, Jeremy Bicha wrote: > On Sun, Oct 22, 2017 at 3:10 PM, Shaun McCance <sha...@gnome.org> > wrote: > > https://github.com/shaunix/ducktype-examples > > Yelp doesn't support Ducktype yet, right? Correct, and adding Ducktype support to Ye

Example Ducktype conversion of gnome-help

2017-10-22 Thread Shaun McCance
Hi all, I took a crack at converting the current gnome-help to Ducktype, just to illustrate how to do things. I'm not doing this to push us to use Ducktype instead of XML. Rather, gnome-help exercises a lot of Mallard features, so having a Ducktype version of it is a good way to see how to do

Re: Thoughts on tagging docs issues in GitLab

2017-09-30 Thread Shaun McCance
Folks, There's a discussion happening on a GitLab issue regarding common labels, including those used for docs. If you're interested, comment there: https://gitlab.gnome.org/GNOME/Infrastructure/issues/22 On Thu, 2017-09-07 at 11:45 -0400, Shaun McCance wrote: > Hi all, > > GNOME

Re: UI/hardcode freeze break request for GNOME Shell

2017-09-11 Thread Shaun McCance
On Fri, 2017-09-08 at 17:48 +0200, Andre Klapper wrote: > On Fri, 2017-09-08 at 16:31 +0100, Allan Day wrote: > > > > This is a break request that changes some visual styling in GNOME > > shell. The code changes are deliberately minimal. However, the > > visual > > change is noticeable. > > > >

Re: Thoughts on tagging docs issues in GitLab

2017-09-08 Thread Shaun McCance
. Maybe the answer is that we should embrace the merge request workflow, with a select few of us keeping tabs on where we can do merges without module maintainer approval. More thoughts? -- Shaun On Thu, 2017-09-07 at 11:45 -0400, Shaun McCance wrote: > Hi all, > > GNOME has beg

Re: Thoughts on tagging docs issues in GitLab

2017-09-07 Thread Shaun McCance
On Thu, 2017-09-07 at 16:53 +0100, David King wrote: > On 2017-09-07 11:45, Shaun McCance <sha...@gnome.org> wrote: > > > > Standardized tag names for docs will help us a lot. Heck, we never > > did > > manage to get standardized component names for docs i

Thoughts on tagging docs issues in GitLab

2017-09-07 Thread Shaun McCance
Hi all, GNOME has begun a slow migration to GitLab. This includes using GitLab instead of Bugzilla for bugs going forward. We need to figure out a way to get a handle on docs bugs across projects. GitLab issues don't have components like Bugzilla, so it doesn't have any sort of per-component

Build help.gnome.org with Pintail

2017-08-04 Thread Shaun McCance
Very much a work in progress here: https://gitlab.gnome.org/shaunm/help.gnome.org -- Shaun ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Re: Proposal: GNOME Docs String Freeze

2017-06-28 Thread Shaun McCance
The subject of a docs string freeze has been tossed around for as long as I've been involved (something like 14 years now). We all generally agree that it would be a good thing if we could do it, but our tight release schedule and understaffed docs team makes it hard. One thing I've been wanting

yelp-xsl wip/html5 -> master

2017-05-23 Thread Shaun McCance
Finally, I have merged the wip/html5 branch of yelp-xsl to master. There will have to be updates to yelp and yelp-tools in this release cycle to match. If you have customizations on top of yelp-xsl (for example, that you pass to yelp-build or pintail), you will almost certainly need to change

Intent to drop faceted navigation from yelp-xsl

2017-05-17 Thread Shaun McCance
As many of you know, I've been working on modernizing yelp-xsl in the wip/html5 branch for some time now. There's one last piece I have to deal with before I can merge to master, and that's facets. Faceted navigation is an experiment I played with many years ago that allows you to navigation by

Re: Intent to drop mouseover links

2017-03-26 Thread Shaun McCance
On Fri, 2017-03-24 at 21:03 +0100, Gunnar Hjalmarsson wrote: > Hi Shaun, > > On 2017-03-24 19:57, Jeremy Bicha wrote: > > > > On Fri, Mar 24, 2017 at 2:14 PM, Shaun McCance <sha...@gnome.org> > > wrote: > > > > > > I want to break mouseover

Intent to drop mouseover links

2017-03-24 Thread Shaun McCance
As some of you know, I have a branch of yelp-xsl called wip/html5 where I'm staging a big pile of cleanups and modernizations to the way Yelp formats stuff, both in app and on the web. It will merge to master when I've broken everything I want to break, so that breakage happens all at once. I

Re: Freeze break request - printer panel layout

2017-03-10 Thread Shaun McCance
Docs folks, since the attachments didn't make their way to the list, here's a handy link to the original post on the release-team list: https://mail.gnome.org/archives/release-team/2017-March/msg00024.html On Thu, 2017-03-09 at 08:59 -0500, Matthias Clasen wrote: > I must say I had a hard time

Re: gnome-help: deprecated ON and OFF gui labels

2016-08-05 Thread Shaun McCance
On pages I've done, I've always written "switch foobar on" and "switch foobar off", not referring to the actual on/off label (which many translations have not used for quite some time). Using images just adds more assets to ship, and has accessibility implications. Using Unicode characters

Pages without licenses

2016-03-31 Thread Shaun McCance
Just noticed we have 13 pages without licenses in gnome-help: $ yelp-check license --only none . accounts-add: none accounts-disable-service: none accounts: none accounts-provider-not-available: none accounts-remove: none accounts-which-application: none accounts-whyadd: none contacts-connect:

No Open Help 2016

2016-03-29 Thread Shaun McCance
Hi all, I've decided to take a year off from running Open Help. It sucks up a lot of my time, and I'm juggling too many other things right now. I wanted you let you all know, because Open Help has been the default venue for our summer hackfest for the last five years. If we want a summer

[yelp-xsl] (2 commits) Created branch gnome-3-20

2016-02-13 Thread Shaun McCance
The branch 'gnome-3-20' was created. Summary of new commits: 693a687... html.xsl: Adding template html.js.script for easier overrid e8cd693... mal-cache.xsl: Don't force xref attribute on info links ___ gnome-doc-list mailing list

Re: Docs hackfest (the winter 2016 edition)

2015-12-04 Thread Shaun McCance
On Fri, 2015-12-04 at 17:09 +0100, Ekaterina Gerasimova wrote: > Hi all, > > On 21 October 2015 at 11:40, Ekaterina Gerasimova > wrote: > > > > Time has come to plan our next hackfest! At our last hackfest at > > Open > > Help, we made good progress on updating

Re: Invitation for webinar at STC - Ref: GNOME Docs presentation at the tcworld14 conference

2015-12-04 Thread Shaun McCance
On Mon, 2015-11-23 at 20:04 +0100, Radina Matic wrote: > > Hello! > > Here in Spain we say "Las cosas de palacio van despacio", or "Palace > wheels grind slowly"... > > Exactly a year after the initial idea about the webinar after my > presentation at tcworld14, I received an "official"

[yelp-xsl] Created branch gnome-3-18

2015-09-12 Thread Shaun McCance
The branch 'gnome-3-18' was created pointing to: b203f52... Updated Chinese (Taiwan) translation ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Re: Work in progress documentation design

2015-07-28 Thread Shaun McCance
On Tue, 2015-07-28 at 20:00 +0200, Andre Klapper wrote: On Tue, 2015-07-28 at 16:17 +0100, Allan Day wrote: Keeping the videos up to date is considerably more work than maintaining static SVGs. If I interpret that correctly: If the videos received more maintenance there'd be no reason to

Open Help Sprint

2015-07-22 Thread Shaun McCance
Hi folks, We have nine people tentatively listed for a doc sprint at Open Help this September: https://wiki.gnome.org/Hackfests/OpenHelp2015 It's my understanding that there is funding available. But to get funding, we need to send a detailed request to the travel committee. If you want to

Hackfest @ Open Help

2015-06-10 Thread Shaun McCance
Hi all, I've set up a wiki page for people interested in doing a docs hackfest at Open Help this year: https://wiki.gnome.org/Hackfests/OpenHelp2015 PLEASE ADD YOUR NAME IF YOU'RE INTERESTED IN COMING. Adding your name is not a commitment. I know many people can only come if sponsored. We can

Re: Hackfests at GUADEC and OpenHelp?

2015-05-29 Thread Shaun McCance
On Fri, May 29, 2015 at 4:15 PM, Shaun McCance sha...@gnome.org wrote: On Thu, 2015-05-28 at 10:45 +0100, Ekaterina Gerasimova wrote: Hi all, GUADEC (7-12th August, Gothenburg) and OpenHelp (26-30th September, Cincinnati) are coming up soon

Re: Hackfests at GUADEC and OpenHelp?

2015-05-29 Thread Shaun McCance
On Thu, 2015-05-28 at 10:45 +0100, Ekaterina Gerasimova wrote: Hi all, GUADEC (7-12th August, Gothenburg) and OpenHelp (26-30th September, Cincinnati) are coming up soon. There will be hacking days at both conferences which would be great opportunities to do some writing. Who would be

Conditional tokens for distro and version

2015-05-06 Thread Shaun McCance
I just added support for querying the distro for conditional processing in Yelp: https://git.gnome.org/browse/yelp/commit/?id=176c25 This looks at the os-release file (if present) and sets platform tokens for the distro id and the distro id+version. On the computer I'm typing this email on, it

Open Help 2015

2015-04-22 Thread Shaun McCance
Hi all, I'm hosting the Open Help Conference Sprints again this year: http://conf.openhelp.cc/ The conference is September 26-27. As usual, Open Help hosts sprints for three days after the conference, September 28-30. It would be awesome to have all my GNOME friends back out for another

[yelp-xsl] Created branch gnome-3-16

2015-04-03 Thread Shaun McCance
The branch 'gnome-3-16' was created pointing to: d05795d... html.xsl: Make sure TTML spans are displayed inline, #74655 ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list

Re: Docs Status

2014-12-07 Thread Shaun McCance
Thanks all for your responses. If you'd like, you can fill out a quick survey on the subject: http://goo.gl/forms/2XvJR3hB6s On Fri, 2014-12-05 at 16:07 -0500, Shaun McCance wrote: Hi all, I'm working on generalizing the page-level status tracking we've used for a few years now to get buy

Docs Status

2014-12-05 Thread Shaun McCance
Hi all, I'm working on generalizing the page-level status tracking we've used for a few years now to get buy-in from some other projects on a common documentation lifecycle. Recall ours looks like this: https://wiki.gnome.org/DocumentationProject/StatusTracking And it got non-normatively

Re: Next (winter) docs hackfest?

2014-10-13 Thread Shaun McCance
On Mon, 2014-10-13 at 20:32 +0100, Ekaterina Gerasimova wrote: I would like to offer Norwich again, the features are: - free venue at UEA (University of East Anglia) with reasonable internet access - we can offer at least 8 free sleeping places (possibly more depending on how cosy you

Re: Next (winter) docs hackfest?

2014-10-01 Thread Shaun McCance
On Mon, 2014-09-29 at 17:28 +0100, Ekaterina Gerasimova wrote: Hi all Last year, we had our winter hackfest in Norwich, UK, in the week leading up to FOSDEM. I remember that there was some interest in proposing new locations, and the venue at Norwich is also available again. I think that

  1   2   3   4   5   6   7   8   >