Skip to main content

Visit Mozilla.org

Talk:XUL Tutorial

From MDC

Contents

[edit] TODO

  • go back through pages for first two chapters and ensure that all element, attribute, and values are enclosed with code tags.
code tags? Not wiki links? Why? (<-- semi-serious) I think one of the best things about having this stuff all in one wiki is that it can be massivly linked together; nearly all element, attributes and methods(be they XUL, Javascript or DOM) ought to be linked to their aproriate reference pages. JesseW 13:56, 14 Jun 2005 (PDT)
  • sort out getting examples and other files into CVS, along with the rest of devmo samples and presentations.

[edit] Can I create a new images of examples in XUL tutorial?

I started creating new of screenshot in Polish version of XUL tutorial. Executed they are Firefoksa on default profile. Can I execute English version of this examples? They are my sentence about many prettier than screen which are in XUL tutorial at now. Example in polish MDC -> http://developer.mozilla.org/pl/docs/Grafika:buttons2.png which is the same image in english MDC -> http://developer.mozilla.org/en/docs/Image:buttons2.jpg Ptak82 05:54, 6 July 2006 (PDT)

I think doing new and better images for examples is fine, yes. --- dria 07:53, 6 July 2006 (PDT)

[edit] Recommended Templates

I try to pick up recommended templates for XUL Tutorial articles. -- Morishoji 19:46, 20 October 2006 (PDT)

See MDC:Custom_Templates. Common templates should be listed there. --Nickolay 18:21, 21 October 2006 (PDT)

[edit] Removed

  • Template:DOMMeth - DOM Method xref
  • Template:DOMProp - DOM Property xref
    • These templates are wrong, because the DOM reference has a different structure than the XUL reference. 'An element's property' is not the same as 'DOM property'. We should use either {{dom|document.getElementById}} template or a bunch of more specific ones, like {{DOM:document|getElementById}}. --Nickolay 18:21, 21 October 2006 (PDT)
      • I understand, then I try to create new template Template:domxref for DOM xref. -- Morishoji 06:56, 24 October 2006 (PDT)
        • Thanks, but I'm not sure the new template is enough either, as at least in the DOM reference the properties and methods are often referred to as Object.property, e.g. document.getElementById. Perhaps there should be a few different templates for linking to the DOM reference.
          I think Template:domxref should be similar to other xref templates - i.e. [[DOM:{{{1}}}|{{{1}}}]] - and the version XUL reference needs should be called differently. I don't have a good suggestion for it yet. --Nickolay 09:01, 24 October 2006 (PDT)

Thanks for informative comments. But, in my mind, most important reason using xref templetes is dependency reducing within articles and references (location/structure), then templates like {{domxref|document|getElementById}} are more suitable, I think. And I also think, if variation templates are needed, creating templates like below is better:

  • {{domxref|document|getElementById}} puts getElementById
  • {{domxref-f|document|getElementById}} puts document.getElementById

Or, if document.getElementById were more common then:

  • {{domxref|document|getElementById}} puts document.getElementById
  • {{domxref-n|document|getElementById}} puts getElementById

(I don't know which is more common...) -- Morishoji 09:03, 25 October 2006 (PDT)

I see your point. Unfortunately you can't completely hide the reference's structure behind a template, i.e. if we make changes to the DOM ref, we'll most likely have to update the templates and all the pages using these templates. Because of this, I see the increased readability as the main benefit of xref templates.
The reasons I'd like domxref template match other xref templates is that
  • otherwise you can't link to pages like DOM:document using the template
  • it's not consistent with other xref templates, making it harder to remember.
  • the provided abstraction is weak; we're least likely will change the delimiter between the object name ('document') and the property name ('getElementById') in the article's name. --Nickolay 09:36, 25 October 2006 (PDT)
I may understand why DOM xref templates is absent. For the time being, I stop using template for DOM xref. I update Template:domxref like other, but if no use, please delele. Thanks. -- Morishoji 06:21, 26 October 2006 (PDT)
Retrieved from "http://developer.mozilla.org/en/docs/Talk:XUL_Tutorial"