Closed Bug 1494229 Opened 2 years ago Closed 2 years ago

Create user story template for mentored bugs

Categories

(Testing :: Marionette, enhancement, P1)

enhancement

Tracking

(firefox64 fixed)

RESOLVED FIXED
mozilla64
Tracking Status
firefox64 --- fixed

People

(Reporter: ato, Assigned: whimboo)

Details

Attachments

(2 files)

Instead of the ‘New contributors’ tutorial at
https://firefox-source-docs.mozilla.org/testing/marionette/marionette/NewContributors.html,
which is largely outdated, we want to create a user story template
that we can attach to all mentored Marionette bugs.

This bug will track creating such a text file under testing/marionette/doc
and removing NewContributors.md.
Assignee: nobody → hskupin
Priority: -- → P3
Hello,
I'm an absolute beginner and would like to work on this.
Hello Devika, I don’t think this is a great first bug for you to
look at.  It is also assigned to Henrik, who is a staff member
heavily involved with mentoring new contributors.

Did you take a look at https://codetribute.mozilla.org/?
Status: NEW → ASSIGNED
Priority: P3 → P1
(In reply to Henrik Skupin (:whimboo) from comment #4)

> DONTBUILD

Note that you actually need to build this for it to appear on
firefox-source-docs.m.o.
Pushed by hskupin@mozilla.com:
https://hg.mozilla.org/integration/autoland/rev/17432131026d
[marionette] Improve documentation for new contributors. r=ato
https://hg.mozilla.org/integration/autoland/rev/228e7fe15459
[marionette] Advertise Phabricator for submitting patches in the docs. r=ato
https://hg.mozilla.org/mozilla-central/rev/17432131026d
https://hg.mozilla.org/mozilla-central/rev/228e7fe15459
Status: ASSIGNED → RESOLVED
Closed: 2 years ago
Resolution: --- → FIXED
Target Milestone: --- → mozilla64
Something seems to be broken with doc generation. The following commit changes three different files:

https://hg.mozilla.org/mozilla-central/rev/17432131026d

While Building.html has been updated, the Testing.html and NewContributors.html files aren't:

https://firefox-source-docs.mozilla.org/testing/marionette/marionette/Building.html
https://firefox-source-docs.mozilla.org/testing/marionette/marionette/Testing.html
https://firefox-source-docs.mozilla.org/testing/marionette/marionette/NewContributors.html

Here is the build log:
https://treeherder.mozilla.org/logviewer.html#?job_id=206465281&repo=mozilla-central&lineNumber=1478-1480

Andrew, are you still the to ask about those problems, or is someone else covering this area those days? May you know what's going on here?
Flags: needinfo?(ahal)
Looks like they're updated to me?

There's a probably a CDN that's doing some caching and takes awhile to update, or maybe you had a local version cached in Firefox.
Flags: needinfo?(ahal)
It's not been updated for me. I will keep this on my radar and check again on Monday.
Flags: needinfo?(hskupin)
Just to clarify what I tested, in https://firefox-source-docs.mozilla.org/testing/marionette/marionette/Testing.html I see "All these tests can be run by using mach" which looks like it was added by the above commit.

Check your URL, awhile back the path was regressed and then we fixed it. Maybe those old incorrect paths are still lying around on the server and you still happen to have it in your history.
Now also the last file has been updated, and it looks fine now. This might indeed be related to CDN and some kind of caching. I will keep this in mind.
Flags: needinfo?(hskupin)
You need to log in before you can comment on or make changes to this bug.