Home / Learn / Insights / Context – Where are we?

Context – Where are we?

I’m occasionally asked “What’s the most re-usable bit of a model – where should I start?“.

It’s a fair question, and answer #1 is always the Glossary.

But answer #2 is a variation: it’s the overview of a project.

Sounds like an obscure piece of information: after all, surely the goals for that project, or it’s stakeholders are more interesting. But everyone who looks at the goals or the stakeholders would also benefit from a ‘project summary in one paragraph’. Or in 3 paragraphs. Or in one pretty diagram (not a model diagram – a diagram from the PowerPoint introduction presentation).

It turns out that these simple introductions get read, and re-used, time after time.

Sure, they aren’t part of the formal deliverables from the project, but think how you’d introduce a new person to the project - you’d give them the ‘5 minute introduction’.

I tend to have a range of ‘context’ information:

  1. Project/Program in one paragraph (no diagrams)
  2. …in 3 paragraphs
  3. …in one diagram

..and I might use (1) and (3) together, or (2) and (3).

And for sure EVERY document you create about the project will have this ‘5 minute introduction’ right at the front, which is why I think it’s so useful.

Not rocket science, but then much of knowledge curation is applied common sense.

More Insights

Different documents for Different People

16 November 2018

How to tailor information to each user - making it as easy as possible for everyone to engage with your work, project or deliverables.

Learn More

Document or Model View?

21 May 2018

Use your documents as an alternative to Model Views.

Learn More

Color your Knowledge

25 October 2017

A while ago a client asked me to look at some process diagrams which had been created for them by a well-known consultancy.

Learn More


12 October 2017

In a recent talk, I asked the audience of about 100 BAs which of them maintained a glossary as part of their work.

Learn More

Hard and Soft

11 October 2017

No, not about Brexit… More about styles of Business Analyst.

Learn More

Printing connectors

18 October 2016

Creating documents that start with the connections between the things in your model

Learn More

Model curation techniques for EA

6 September 2016

How cleaning, navigating and validating your EA model makes sharing and collaborating much more effective.

Learn More

Branch/Merge with EA13

11 August 2016

One of the most common requests we see from new EA users is: "Why can’t I do branch/merge with EA?

Learn More

7 Steps to Agile Documents

8 September 2015

Or “How documents can HELP your project, not stop it"

Learn More

Compare pricing and features

Choose the eaDocX edition that’s right for you and your team

Compare Pricing

Download a free trial

Take a free, no obligation, 30-day trial of eaDocX. Discover for yourself why it’s the world’s best-selling Enterprise Architect extension.