Add some inclusions+howto

nesting, also called nested cards, are basically cards within cards.  Wagn's use of inclusions is very extensive, and it's one of the things that really makes Wagn special.  If you've made it this far on the road to Become a Wagneer, you've seen inclusions before.  Remember seeing the Sandbox card inside the Edit some cards step?  It looked something like this:

Idea

Sandbox+priority

 

 

 

Sandbox+example

test

 

Sandbox+relevant user stories

 
 

Including a card isn't just like copying and pasting content; it actually puts one card inside another.  You can edit the inner and outer cards separately, and if the inner card changes in one place, it changes everywhere it appears, which is why this kind of inclusion is sometimes called transclusion.  The term is accurate here, but folks find it scary, so we avoid it.

 

Now you're going to learn how to include some cards yourself.  First, pick a card to play with (preferably not the Sandbox - we want to leave that for less experienced Wagneers).  You've had some practice creating new cards, so you can create a new one to experiment with, or you can use an existing play card.  From here forward we'll refer to this as your sandbox card.

 

Let's include a card inside your sandbox card.  In these examples we'll use the nymph image.  Feel very free to choose another.  We'll refer to this as your nested card.

 

OK, you're ready.  Edit your sandbox card and add the name of your nested card -- in curly brackets.  Like this:

{{nymph}}

Now click save.  You just included that card.  You'll notice that if you double-click on the nested card, you can edit it.  However, you don't see a header (the green background with the name in it) for that card.  That's because by default, when you include a card, what you get is its content.  But sometimes you might like to have a different view of that card.  You might want to see it open with the header on top.  You might want to see it closed.

 

Using the instructions on the nesting+howto page, try adding the following to your sandbox card:

  1. an open view of the nymph, with the card header showing.
  2. a closed view of the nymph