[doc] Add ADR on support for forking table view description

Signed-off-by: Michaël Charfadi <[email protected]>

CHANGELOG.adoc

@@ -28,6 +28,7 @@
 - [ADR-169] Compute the icon of a representation
 - [ADR-170] Add support for representations in the Details View
 - [ADR-171] Add support for Sorting and Filtering in Tables
+- [ADR-172] Add support for forking table description from representation
 
 === Deprecation warning
 

doc/adrs/172_add_support_for_forking_table_description_from_representation.adoc

@@ -0,0 +1,47 @@
+= ADR-172 Add support for forking table description from representation
+
+== Context
+
+On a table representation, we want to be able to modify the specification used as description of this table and then reload the table with this new specification.
+
+== Decision
+
+We will allow users to open a new studio from an opened table representation.
+This new studio will contain a copy of the table description used to instantiate the table.
+After modifying this new studio, the user will be able to re open the previous table representation that will use the updated table description.
+
+=== Back-end
+
+We will implement a new mutation `createForkedStudio` that will fork the description used by the table.
+`createForkedStudio(input: CreateForkedStudioInput!): CreateForkedStudioPayload!`
+```
+input CreateForkedStudioInput {
+  id: ID!
+  editingContextId: String!
+  representationId: String!
+}
+```
+
+The data fetcher will then call an event handler that will :
+
+* Dispose the current editing context
+* Create a new Studio that will be a fork of the description used by the representation
+* Update the representation with the representationId given in the input with the new descriptionId
+* Return the url of the newly created studio (so the front-end can redirect to this url)
+
+=== Front-end
+
+We will add an extension point to contribute to the settings menu item.
+One contribution will add a menu item in order to send the createForkedStudio mutation.
+
+== Advantages
+* This solution does not require deep modification on how we reload representation.
+
+== Disadvantages
+* User Experience: The user that wants to make a change will need to reopen his representation after the changes.
+
+== Status
+
+Work in progress
+
+== Consequences