Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCU-929

Rewrite or replace (old) 'Hello Magnolia' using CLI to full extent

XMLWordPrintable

    • Icon: Story Story
    • Resolution: Done
    • Icon: Neutral Neutral
    • None
    • None
    • None
    • Docu Sprint 26, Docu Sprint 27
    • 13

      The tutorial should replace the current hello magnolia tutorial.
      Hello Magnolia
      has become old - it originates from the days of the 5.4 release.

      Be aware that there is also another, smaller, newer version called
      Hello Magnolia for front-end developers

      Things which are clear so far

      • Use CLI wherever it makes sense
      • There is no more "If you use CLI, do it that way. If not using CLI, do it this way". Avoid explaining the same thing with 2 approaches.
      • Keep the existing example(s) whenever possible; there is no reason to figure out new ones.
      • Example wise the following things are clear:
        • Create a new light module
        • Create a new page template
        • Create a new component template - to be used on the new page template

      Even if we will use CLI wherever possible - the main focus of this tutorial is

      • "Getting started with Magnolia"
      • Understanding some core principles of templating
      • Using CLI is not the main aim - CLI is just a means to an end.

      Things which have not yet been decided:

      • Should we again use a static prototype file as a precursor of the new page template?
        • It is still a very valid use case.
        • It includes a lot of manual work - which is however helpful to learn magnolia
        • It is still possible to do the static prototype first ... then creating a page template via script ... but then adapting the per script generated files by copying parts of the static prototype file
      • How deep do we go in explaining things which are done via CLI commands, which we have explained "in detail" in the old version

        Acceptance criteria

          There are no Sub-Tasks for this issue.

              mdrapela Martin DrĂ¡pela
              jlegendre Julie Legendre
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated:
                Resolved: