Last Comment Bug 868872 - All the links under "Common Thunderbird Use Cases" are dead
: All the links under "Common Thunderbird Use Cases" are dead
Status: NEW
:
Product: Developer Documentation
Classification: Other
Component: Mozilla Platform (show other bugs)
: unspecified
: x86 Mac OS X
: -- normal (vote)
: ---
Assigned To: Nobody; OK to take it and work on it
:
:
Mentors:
: 961359 (view as bug list)
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2013-05-05 16:13 PDT by bernardo
Modified: 2016-11-11 06:52 PST (History)
12 users (show)
vseerror: needinfo? (jonathan.protzenko)
See Also:
QA Whiteboard:
Iteration: ---
Points: ---


Attachments

Description bernardo 2013-05-05 16:13:35 PDT
User Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:20.0) Gecko/20100101 Firefox/20.0
Build ID: 20130326150557

Steps to reproduce:

I went here:
https://developer.mozilla.org/en-US/docs/Extensions/Thunderbird/HowTos
 to know how to develop a thunderbrd extension


Actual results:

The links under "Part 1: Common Thunderbird Use Cases" are dead


Expected results:

they should link to content that would let me learn how to develop my own extension
Comment 1 Jonathan Protzenko [:protz] 2013-07-31 00:10:01 PDT
The old contents are still mirrored on Ben's copy of MDN (e.g. http://mdn.beonex.com/en/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/View_Message.html) but it would be a shame to have all this information lost, it's pretty much all we have for Thunderbird...
Comment 2 John Karahalis [:openjck] 2013-07-31 07:38:28 PDT
Have you checked the revision history?
Comment 3 Jonathan Protzenko [:protz] 2013-08-19 05:28:42 PDT
I have been unable to understand why the links are broken, even looking at the revision history. Is there anyone I can CC to take care of this problem? I'm not a MDN expert by any means, but I know this is bad because right now, pretty much all the documentation for Thunderbird is unusable, and I have to redirect people to mdn.beonex.com.
Comment 4 Frank Wein [:mcsmurf] 2013-10-29 02:04:49 PDT
Is there a way to get the revision history of a deleted page like https://developer.mozilla.org/en-US/docs/Extensions/Thunderbird/HowTos/Common_Thunderbird_Use_Cases/Open_Folder ? If it ever existed, but it looks like it did in the past.
Comment 5 Eric Shepherd [:sheppy] 2013-10-29 05:37:46 PDT
(In reply to Frank Wein [:mcsmurf] from comment #4)
> Is there a way to get the revision history of a deleted page like
> https://developer.mozilla.org/en-US/docs/Extensions/Thunderbird/HowTos/
> Common_Thunderbird_Use_Cases/Open_Folder ? If it ever existed, but it looks
> like it did in the past.

No, there's not; if it's deleted, its history is gone. Sorry!
Comment 6 Jonathan Protzenko [:protz] 2013-10-29 06:05:00 PDT
Eric, this basically means that all the useful documentation for Thunderbird is now dead. There was a significant amount of knowledge in these how-tos, and the static copy on beonex is out-of-date.

1) How could this possibly happen? I've spent an awful lot of time dealing with terrible wiki software to write one third of these how-tos, it is slightly frustrating to see that no one seems to care about this (I had to file a bug and it remained unanswered for several months) and to see that it seems acceptable for all that documentation to be dead.

2) Could someone please look into it seriously and try to find backups or something?

Thanks,

jonathan
Comment 7 Frank Wein [:mcsmurf] 2013-10-29 10:59:03 PDT
Bug 863344 Comment 7 seems to be related here. Back in April developers.mozilla.org seemed to have a problem with a lot of pages disappearing.
Comment 8 Luke Crouch [:groovecoder] 2013-11-21 19:37:24 PST
Sheeri - how old of backups do we have for the MDN database?
Comment 9 Sheeri Cabral [:sheeri] 2013-11-22 06:49:27 PST
We keep 3 days' worth of backups easily accessible. We do not have any longer-term backups sent offsite/to tape or anything like that.

If the information is truly gone, the Internet Archive at www.archive.org may have the content. (and yes, I've often lamented that deleted wiki pages in most systems are actually deleted from the database, and not retrievable).
Comment 10 Luke Crouch [:groovecoder] 2013-11-22 07:53:55 PST
None of them pull up for me on archive.org. :(

Sheeri, can we *start* keeping weekly and/or monthly snapshots for longer-term backups?
Comment 11 Luke Crouch [:groovecoder] 2013-11-22 07:54:23 PST
Sheeri - also, do we have older backups that are *not* easily accessible? ;)
Comment 12 Luke Crouch [:groovecoder] 2013-11-22 08:03:25 PST
I tried copying and pasting the content from beonex.com. It's a little ugly, but it might be easier than starting from nothing:

https://developer.mozilla.org/en-US/docs/User:groovecoder/Compose_New_Message
Comment 13 Sheeri Cabral [:sheeri] 2013-11-22 08:57:29 PST
Luke - we do not have older backups, easily accessible or not. We have been running an EMC Data Domain disk in the other data center to keep backups longer-term, and now that that has been successful (we've been doing this since July, and in fact can keep backups for months), we are waiting on Systems to get a Data Domain system in scl3, where this database is.

I'll find the bug and put you as a cc on it if you like.
Comment 14 Luke Crouch [:groovecoder] 2013-11-22 09:59:06 PST
That would be great, thanks :sheeri.
Comment 15 Will Bamberg [:wbamberg] 2013-11-26 09:50:14 PST
Luke and Sheeri, thanks for looking into this. Jonathan/bernardo, I'm really sorry this content is not recoverable. Jonathan: how badly out of date is the stuff on beonex? If it's worth doing, I'll manually copy it back in the next few weeks.
Comment 16 bernardo 2013-11-26 09:57:30 PST
Even though it took sometime for you guys to get everything up and running, I would like to thank you for taking some time in order to fix this issue.

A couple of months ago I had to make a thunderbird extension for a university project, that would implement a couple of security features. Due to the lack of documentation ended up creating my own app in rails.

With this issue solved, you will make it extremely easier for new comers to start developing Thunderbird extensions.

Best regards
Comment 17 Jonathan Protzenko [:protz] 2013-11-27 01:54:36 PST
Hi Will,

Importing the content from Beonex will definitely help. I think the main problem with the content on Beonex is that some parts that were written in-between the Beonex snapshot and the data loss have been irrevocably lost, but the rest of the content should be fine.

Much thanks,

jonathan
Comment 18 Florian Scholz [:fscholz] (MDN) 2014-10-10 08:36:45 PDT
*** Bug 961359 has been marked as a duplicate of this bug. ***
Comment 19 Jim Porter (:squib) 2015-01-23 12:39:24 PST
Let's just fix this. I'm tired of having such a hard time pointing people to TB docs.

I can just copy everything other from the Beonex shapshot and fix stuff up, right? As far as I know, it's just a mirror of the old content, so there shouldn't be any copyright issues...
Comment 20 Adrian Aichner [:anaran] 2015-10-07 04:24:27 PDT
Hi, I was just going to submit a new bug then I found this one.

Would be great is the external docs could be brought back in to MDN.
Comment 21 Jean-Yves Perrier [:teoli] 2015-10-07 05:14:53 PDT
Adrian: basically it is just the matter of somebody copy /pasting the old content from beonex. Given the internal prioritization of Thunderbird, this task will unlikely be assigned to an employee though.
Comment 22 Jim Porter (:squib) 2015-10-19 14:49:30 PDT
(In reply to Jean-Yves Perrier [:teoli] from comment #21)
> Adrian: basically it is just the matter of somebody copy /pasting the old
> content from beonex. Given the internal prioritization of Thunderbird, this
> task will unlikely be assigned to an employee though.

That's not exactly true. A lot of those docs were bad and probably shouldn't be copied back. I've filled in some of the pages with better docs, but I don't have a lot of time to work on that.
Comment 23 Adrian Aichner [:anaran] 2015-10-19 16:35:57 PDT
(In reply to Jim Porter (:squib) from comment #22)
> (In reply to Jean-Yves Perrier [:teoli] from comment #21)
> > Adrian: basically it is just the matter of somebody copy /pasting the old
> > content from beonex. Given the internal prioritization of Thunderbird, this
> > task will unlikely be assigned to an employee though.
> 
> That's not exactly true. A lot of those docs were bad and probably shouldn't
> be copied back. I've filled in some of the pages with better docs, but I
> don't have a lot of time to work on that.

When (roughly) did you do that?

I had a hard time to find my way into Thunderbird APIs using MDN.

The best resource I found was
http://mxr.mozilla.org/comm-central/source/
and I got help in the #instantbird channel.

nsIEditor referenced in
https://developer.mozilla.org/en-US/docs/Extensions/Thunderbird/HowTos/Access_Message_in_Compose_Window_Editor
is a dead link.

https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Mail_event_system seems to have very old information.

I was trying to find some old archive links referenced from THunderbird docs but I can't find them now.
Comment 24 Jim Porter (:squib) 2015-10-19 17:52:55 PDT
Around when I assigned the bug to myself, so January.
Comment 25 Jim Porter (:squib) 2016-06-04 12:49:38 PDT
This is better now, but not perfect. Anyone else who wants to help on this is welcome to.
Comment 26 u578587 2016-08-31 04:24:55 PDT
(In reply to Jonathan Protzenko [:protz] from comment #3)
> I have been unable to understand why the links are broken, even looking at
> the revision history. Is there anyone I can CC to take care of this problem?
> I'm not a MDN expert by any means, but I know this is bad because right now,
> pretty much all the documentation for Thunderbird is unusable, and I have to
> redirect people to mdn.beonex.com.

Just an FYI, 3 years later: the docs on beonex are TERRIBLE. I did Javascript development off and on for 10 years, and can't make head or tail of how to get done what I need to do from what they're telling me. It doesn't seem to be designed such that people who don't already know it all backwards and forwards will have much luck making sense of it.
Comment 27 u578587 2016-08-31 04:27:44 PDT
Oh, ****- why is this board publishing my email address publicly? Delete! DELETE! DELETE!
Comment 28 u578587 2016-08-31 04:31:30 PDT
Ok. Newbie freaking out here. Get my email address off this page.
Comment 29 u578587 2016-08-31 04:32:35 PDT
Wow. Can't delete my account, can't change my email address, can't delete these comments... somebody please delete all this stuff.
Comment 30 Wayne Mery (:wsmwk, NI for questions) 2016-11-11 06:52:25 PST
protz, thanks for all the work on this. I'd like to finally get this bug sorted out so...

per https://developer.mozilla.org/en-US/Add-ons/Thunderbird/HowTos$history there has been many updates to the MDN and the links point to much of the material that was lost. Yet, the "This page is badly broken" warning remains.

Is there a list or non-trivial way to determine what's left to be done?  
And it seems to me that a restore per bug 863344, which seem to have dropped off the floor, is no longer wanted.  Correct?

Note You need to log in before you can comment on or make changes to this bug.