272172 - Add readme to latest* directories explaining what's in them

Status: VERIFIED FIXED

(mozilla.org :: FTP: Staging, task)

Description

[Prognathous]

Of the three nightly folders, two are clearly separated: /latest-trunk and
/latest-1.7 (branch). The third one, /latest, is just confusing and ambiguous.

Two possible solutions:

1. "Kill it" (to quote Asa, https://bugzilla.mozilla.org/show_bug.cgi?id=67445#c7)
-or-
2. Add some stub at the top of the folder that explains what it is ("!This
folder is link to latest-trunk")

Prog.

Comment 1

[Zach Lipton [:zach]]

One potentially significant issue with this is that people and automated pulling
scripts expect builds to be in /mozilla/nightly/latest and any change will break
these existing systems. 

Comment 2

[Prognathous]

Replacing "latest" with "latest-trunk" in these automated scripts should be very
simple. All we have to do is document this change, and for this type of
audience, b.m.o should suffice.

Nevertheless, if you're really worried about the implications of removing this
folder, the second option still stands.

Prog.

Comment 3

[timeless]

replacing text in scripts that may never update and run on uncounted/unknown
boxes is nontrivial

Comment 4

[Prognathous]

So I guess that leaves us with the second option. I'm fine with it.

Prog.

Comment 5

[Asa Dotzler [:asa]]

We've discussed this several times in the past and decided against making either
of these changes. 

Comment 6

[Prognathous]

For the record, may I ask what was the rational in deciding against the second
option?

Thanks,

Prog.

Comment 7

[Asa Dotzler [:asa]]

Oh, a readme inside of each folder would be fine. Handing this to Chase. If he
cares about it, he can either do it or review any patches.

Comment 8

[Prognathous]

Attachment: Draft README file for /latest

How about this one?

Prog.

Comment 9

[Prognathous]

Comment on attachment 168180 [details]
Draft README file for /latest

Who do I have to contact to get this in? Do readme files require reviews?

Prog.

Comment 10

[Chase Phillips]

I've added these suggested README files to mozilla/nightly/latest*.  Thanks for
offering them!

Comment 11

[Prognathous]

Verified. Thanks Chase for putting this in.

Prog.