Page MenuHomePhabricator

[MITKDoc] Add a concept documentation for the data storage inspectors and the overhaul of the selection concept
Closed, ResolvedPublic

Description

In D126#2692, @kislinsk wrote:

I noticed that it's a bit hard to understand the overall concept when dive right into a review of the essential classes. Hence I would like to suggest you to write a concept documention page about the data storage viewers. Despite the very good class documentation you already wrote, concept pages in our documentation turned out to be the number one source for understanding concepts. It would fit perfectly into "Data Concepts" I guess: http://docs.mitk.org/2016.11/Concepts.html.

It's a good point. We should add pages that explain

  • the reasoning for the new/improved (local) selection concept
    • How to use it in own widgets (the currently available selections widgets)
    • How to introduce own selection widgets/control structures (deriving from our abstract classes)
  • the data storage inspectors and their jobs
    • How to use custom inspectors the modify selections widgets (via NodeSelectionDialog and MicroServices)
    • Preference settings for NodeSelectionDialog and how to preset how a custom application handles selections.

Revisions and Commits

rMITK MITK
Restricted Differential Revision
Restricted Differential Revision
Restricted Differential Revision
Restricted Differential Revision
Restricted Differential Revision
Restricted Differential Revision
Restricted Differential Revision

Event Timeline

@kalali could you be so kind and start with a draft vor the pages?

kalali triaged this task as Normal priority.May 29 2018, 2:14 PM

I added the first draft as a doxygen file. The documentation can be build and then displayed by opening the file: MITK-build/Documentation/Doxygen/html/SelectionConceptPage.html

Is the PDF you've sent me out dated or still valid?

Now it's out dated. I added some parts and changed some sentences. However, if you already have some comments you can send it to me and I can include them for the next commit.

kalali renamed this task from Add a concept documentation for the data storage inspectors and the overhaule of the selection concepts to Add a concept documentation for the data storage inspectors and the overhaul of the selection concept.Jan 10 2019, 3:48 PM
kalali updated the task description. (Show Details)
kalali renamed this task from Add a concept documentation for the data storage inspectors and the overhaul of the selection concept to [MITKDoc] Add a concept documentation for the data storage inspectors and the overhaul of the selection concept.Jun 24 2020, 10:35 AM
kalali raised the priority of this task from Normal to High.
kalali added a revision: Restricted Differential Revision.Sep 14 2020, 1:13 PM