"Defining Quote" Snippet Type?

[Mettius]

Page 18 of the Realm Works Reference Guide indicates (for a people topic) under Profile there should be a snippet type "Defining Quote". I can't figure out how to add it.

[daplunk]

Alot has changed in recent times. It's possible the documentation is not up to date with the current status. I can't confirm this but having worked in IT for a long time it would not surprise me. Documentation is usually an afterthought.

[Avi]

Originally Posted by daplunk

Documentation is usually an afterthought.

BUT BUT the proper design pattern says we should write documentation first and then design from it

[craghammer]

Originally Posted by Avi

BUT BUT the proper design pattern says we should write documentation first and then design from it

I've always thought the code should be good enough to not need documentation - that also spans to the User Experience.

But, needless to say - RW does have some quirks in the UI that makes it less than intuitive and documentation is needed.

As for the "defining quote" snippet - It's easy to add a snippet in the category definition and set it to have the quote default snippet type. Set it to Auto-Add on the topic and new topics would have this. For current topics, use the wrench tools and quick edit - synchronize to topic definition.

[Farling]

Originally Posted by Avi

BUT BUT the proper design pattern says we should write documentation first and then design from it

Doesn't Agile development mean that new features are added, and old features are modified/rationalised, as part of the continual development of a good product?

This leads to any up-front documentation becoming out-of-date very quickly.

Automated tools to extract documentation embedded in the source code is a far better way to get devs to maintain it

[daplunk]

Big difference between design documentation and client facing documentation also.

[meek75]

Perhaps the "flavor" snippet style has replaced the quote snippet?

[Mettius]

So, software development methodologies aside , I only posted this because I had a memorable quote for an NPC I was entering into RW and wasn't sure where the "best practice" was to put it. ...so I read the fine manual and it delightfully pointed me to the defining quote snippet ...which seems to be gone. So this is a combination question on best practice for where to put said quote, and to report a defect in the documentation I guess.

[Farling]

Originally Posted by Mettius

So, software development methodologies aside , I only posted this because I had a memorable quote for an NPC I was entering into RW and wasn't sure where the "best practice" was to put it. ...so I read the fine manual and it delightfully pointed me to the defining quote snippet ...which seems to be gone. So this is a combination question on best practice for where to put said quote, and to report a defect in the documentation I guess.

I guess they are now put into normal text snippets, but change the snippet style to either read-aloud or flavour.

[Vargr]

I make a (or several) custom snippet called "BTL" which stands for "Bring to life" - for each snippet I write one thing that makes the character stand out, such as:

BTL: Swears at least twice in every sentence.
BTL: Has a deep husky voice [this for a female NPC]
BTL: Lacking pinky and ring finger on left hand.
BTL: Famous quote: "Rather ya than me, know what a mean?"