On Tuesday 2016-05-31 23:59 -0400, Eric Shepherd wrote:
> Found myself looking at this page today, which is now labeled as
> potentially obsolete due to not having undergone any substantial changes
> in many years. Could someone please look it over and let me know if it's
> worth keeping or salvageable at least?
> 
> https://developer.mozilla.org/en-US/docs/Modularization_Techniques
> 
> If it's worth keeping, I'll move it to the Mozilla documentation area.
> If not, the archival area.

I think it's not salvageable in the sense of being turned into
documentation that tells people what they ought to be doing.  Almost
all of the things it recommends are poor practice today because we
have macros or other helpers that do them in much simpler (and in
some cases also more efficient) ways.

However, I think it's historically quite interesting for people
trying to understand how XPCOM works, because it shows the basic
pieces of the XPCOM component model and how they can be implemented
(but probably shouldn't be anymore) in a nice and simple way, before
they were obscured by lots of macros, and by lots of performance and
code size optimizations hidden underneath even more macros.

So I tend to think it's worth keeping, but with a preface that
clearly labels it as historical and no longer good practice, and
perhaps with an appendix pointing to the current practices.

-David

-- 
𝄞   L. David Baron                         http://dbaron.org/   𝄂
𝄢   Mozilla                          https://www.mozilla.org/   𝄂
             Before I built a wall I'd ask to know
             What I was walling in or walling out,
             And to whom I was like to give offense.
               - Robert Frost, Mending Wall (1914)

Attachment: signature.asc
Description: PGP signature

_______________________________________________
dev-platform mailing list
dev-platform@lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-platform

Reply via email to