add hat tree linking language + minor fixes #100

more-reese · 2023-02-24T15:38:06Z

Update language in Hat Tree linking section to reflect David's feedback in moreReese<>Hats telegram group (sent 23 February 2023)
Fix broken internal links to section headers

davehrlichman · 2023-02-25T01:17:16Z

user_guide/user_guide.md

+# Hat Tree linking
+This powerful feature lets you graft two trees together, by linking the Top Hat from one tree to a hat from another tree.
+
+When this happens, as seen in the diagram, the level 2 hat from Tree 1 becomes the admin for the Top Hat of tree 2, and therefore the Top Hat of Tree 2 effectively becomes a level 3 hat in Tree 1. The previous Top Hat from the now nonexistent Tree 2 will then hold the same properties as as any other hat in Tree 1, with one distinction: the Top Hat and its child hats can be unlinked from Tree 1 at any point in the future, thereby returning back to the initial state of having two separate hats trees. 


Suggested change

When this happens, as seen in the diagram, the level 2 hat from Tree 1 becomes the admin for the Top Hat of tree 2, and therefore the Top Hat of Tree 2 effectively becomes a level 3 hat in Tree 1. The previous Top Hat from the now nonexistent Tree 2 will then hold the same properties as as any other hat in Tree 1, with one distinction: the Top Hat and its child hats can be unlinked from Tree 1 at any point in the future, thereby returning back to the initial state of having two separate hats trees.

davehrlichman · 2023-02-25T01:18:50Z

user_guide/user_guide.md

+
+<img src=./assets/hatTreeLinking2.png  width="600" height="350">
+
+If approved, Hat Tree 2 links, or "grafts", to Hat Tree 1. The approving hat becomes the admin hat the Top Hat from Hat Tree 2.


Suggested change

If approved, Hat Tree 2 links, or "grafts", to Hat Tree 1. The approving hat becomes the admin hat the Top Hat from Hat Tree 2.

If approved, Hat Tree 2 links, or "grafts", to Hat Tree 1. The approving hat becomes the admin hat of the Top Hat from Hat Tree 2.

davehrlichman · 2023-02-25T01:19:39Z

user_guide/user_guide.md

+
+<img src=./assets/hatTreeLinking3.png  width="600" height="400">
+
+


The Top Hat from Tree 2, along with its associated branch, can be unlinked from Tree 1 at any point in the future, thereby returning back to the initial state of having two separate hats trees.

davehrlichman · 2023-03-03T23:04:54Z

user_guide/user_guide.md

+You can mint a Top Hat with the `mintTopHat` function, which creates and mints a hat that is its own admin*, i.e. a `topHat`.
+
+
+_*Note: New functionality is coming soon that will enable Top Hats and their associated trees to be linked and unlinked to other existing Hats trees, by changing the admin of a Top Hat._


Delete "*Note: New functionality is coming soon that will enable Top Hats and their associated trees to be linked and unlinked to other existing Hats trees, by changing the admin of a Top Hat."

davehrlichman · 2023-03-03T23:05:19Z

user_guide/user_guide.md

+*_These characteristics are new in v1_
+
+
+You can mint a Top Hat with the `mintTopHat` function, which creates and mints a hat that is its own admin*, i.e. a `topHat`.


Delete the * after "admin"

davehrlichman · 2023-03-03T23:05:45Z

user_guide/user_guide.md

+
+<span style="color: red; font-weight: bold">   DRAFT </span>Last updated: 9 February  
+
+_Please add comments as you use this draft guide for anything that you feel could be clarified, improved, or added — thank you!_


Delete "draft"

davehrlichman · 2023-03-03T23:06:38Z

user_guide/user_guide.md

+## Step 3: Paste `id` in the `viewHat` function on the `Read Contract` page
+
+# Eligibility and Toggle
+Eligibility and toggle are dynamic and extensible modules that have the authority to rule on a hat wearer’s eligibility and standing (eligibility module) and switch the status of a hat (toggle module).


Add "on and off" just after "switch the status of a hat"

davehrlichman · 2023-03-03T23:07:04Z

user_guide/user_guide.md

+
+The eligibility and toggle design space is huge. Future guides will dive deeper and explore more complex implementations of eligibility and toggle logic. This guide focuses on a simple implementation: setting eligibility and toggle as an address that determines eligibility and toggle for a given hat. This involves two contracts: `changeHatEligibility` and `changeHatToggle`.
+
+By default, we recommend setting the eligibility and toggle addresses to the DAO's address (or the address wearing the Top Hat), so that the DAO retains the power to revoke hats and turn them off by vote, until more structure is put in place." might also be good to mention this when creating the hat in the first place.


Delete "might also be good to mention this when creating the hat in the first place."

davehrlichman · 2023-03-03T23:07:23Z

user_guide/user_guide.md

+   </td>
+  </tr>
+</table>
+


Add "By default, we recommend setting the eligibility and toggle addresses to the DAO's address (or the address wearing the Top Hat), so that the DAO retains the power to revoke hats and turn them off by vote, until more structure is put in place."

more-reese added 2 commits February 9, 2023 22:46

Add files via upload

c709014

add hat tree linking language + update broken internal links

2e22c75

davehrlichman closed this Feb 26, 2023

davehrlichman reopened this Mar 3, 2023

davehrlichman requested changes Mar 3, 2023

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

add hat tree linking language + minor fixes #100

add hat tree linking language + minor fixes #100

more-reese commented Feb 24, 2023

davehrlichman Feb 25, 2023

davehrlichman Feb 25, 2023

davehrlichman Feb 25, 2023

davehrlichman Mar 3, 2023

davehrlichman Mar 3, 2023

davehrlichman Mar 3, 2023

davehrlichman Mar 3, 2023

davehrlichman Mar 3, 2023

davehrlichman Mar 3, 2023


		<img src=./assets/hatTreeLinking2.png width="600" height="350">

		If approved, Hat Tree 2 links, or "grafts", to Hat Tree 1. The approving hat becomes the admin hat the Top Hat from Hat Tree 2.


		<img src=./assets/hatTreeLinking3.png width="600" height="400">

		You can mint a Top Hat with the `mintTopHat` function, which creates and mints a hat that is its own admin*, i.e. a `topHat`.


		_*Note: New functionality is coming soon that will enable Top Hats and their associated trees to be linked and unlinked to other existing Hats trees, by changing the admin of a Top Hat._

		*_These characteristics are new in v1_


		You can mint a Top Hat with the `mintTopHat` function, which creates and mints a hat that is its own admin*, i.e. a `topHat`.


		<span style="color: red; font-weight: bold"> DRAFT </span>Last updated: 9 February

		_Please add comments as you use this draft guide for anything that you feel could be clarified, improved, or added — thank you!_


		The eligibility and toggle design space is huge. Future guides will dive deeper and explore more complex implementations of eligibility and toggle logic. This guide focuses on a simple implementation: setting eligibility and toggle as an address that determines eligibility and toggle for a given hat. This involves two contracts: `changeHatEligibility` and `changeHatToggle`.

		By default, we recommend setting the eligibility and toggle addresses to the DAO's address (or the address wearing the Top Hat), so that the DAO retains the power to revoke hats and turn them off by vote, until more structure is put in place." might also be good to mention this when creating the hat in the first place.

add hat tree linking language + minor fixes #100

Are you sure you want to change the base?

add hat tree linking language + minor fixes #100

Conversation

more-reese commented Feb 24, 2023

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment