Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Educational Materials #109

Closed
0x4007 opened this issue Jan 9, 2025 · 68 comments
Closed

Educational Materials #109

0x4007 opened this issue Jan 9, 2025 · 68 comments

Comments

@0x4007
Copy link
Member

0x4007 commented Jan 9, 2025

We should develop educational materials that showcase the system’s features through multimedia elements such as photographs, videos, and a blog-style narrative.

These materials should be integrated into our marketing and sales strategies to effectively communicate the advantages of UbiquityOS.

Given the amount of features that we have, it might make sense to prioritize features that may be more "sexy" and stream out the content over time.

This first task can highlight our AI related features such as:

  • talent recommendation
  • issue deduplication
  • conversation scoring
  • /ask

I also think that we should explain the core architecture of our system and how everything revolves around the concept of "tasks" with associated priority and time labels.

Each post should include images and possibly even a voice over video if it makes sense to.

These can be delivered on our notion at dao.ubq.fi

@minhyeong112
Copy link
Collaborator

I think the best way to educate others about the features is to show UbiquityOS in action. Are there any particularly smooth issues (that show many of the awesome features) or shall I look for some?

@0x4007
Copy link
Member Author

0x4007 commented Jan 9, 2025

particularly smooth issues

Some old ones i have saved for pitching

ubiquity-os-marketplace/command-start-stop#64 (comment)

ubiquity/ubiquity-dollar#611 (comment)

@0x4007
Copy link
Member Author

0x4007 commented Jan 9, 2025

This is a very rough draft. Normally I would pass it through an LLM to rewrite but I'm in a bit of a transit/rush.

UbiquityOS Overview

Test

UbiquityOS Capabilities

/help

  • you can configure your own instance of UbiquityOS with plugins from our marketplace.
  • the help menu wil provide you information on the currently configured commands. Eventually it will also provide an overview of all the plugins configured which handle other automations and which may not have direct commands to invoke those tools.
  • organization wide defaults with local project overrides is supported.

/wallet

  • user wallet registration. this is essential for receiving rewards.
  • rewards can be automatically transferred to contributors upon project completion, or offchain payment permits can be generated for later claims (gas claim fee is paid by the contributor)

/start

  • this is used to self assign tasks.
  • admins can configure the required criteria for the user to self assign tasks.
    • for example, by default only two tasks can be worked on concurrently by contributors in order to promote focus. however, it also accommodates exceptions like if there are delays in the review process, then the contributor can start on an extra task.
  • given the collaborator's status (admin/team member/external/XP) task gating can also be configured.
    • for example, high priority tasks can only be worked on core team members, while external contributors can only work on the short and low priority tasks
  • we are also doing research around seeing if the contributor has worked on similar type of work in the past and only then to allow self assignment.
    • for example, a user worked on a similar open source project six months prior. we check all of those project specifications and languages they used in order to determine whether they are likely to be a good candidate for the current task.
  • this mitigates unqualified candidates from blocking tasks from more qualified ones.

/stop

  • self unassignment. this is primarily used to formally give up a project without being punished via docking XP

assistive pricing

  • the project specification author should set a course time estimate for any newly posted project in the form of a label prefixed with Time:
  • project managers/administrators should set a priority level using a label prefixed with Priority:
  • once both labels are set, a configurable lookup of pricing in the form of a label prefixed with Price: will be automatically set
  • in the future we are saving all of the previously completed issue labels to help automatically determine pricing for new issues without contributors setting the priority and time label dependencies.

text-conversation-rewards

  • UbiquityOS has the ability to compensate team members for their communications related to any project. If contributors are providing high value inputs, such as writing clear specifications, clear work reviews, adding any information or research to clarify the projects, or in general to help other team members complete the task successfully, they will be rewarded accordingly.
  • we use AI to determine how relevant a comment is to the task at hand
  • we also allow for manual configuration of rewards related to what types of comments they write, for example if they include images, links, and code snippets they would be rewarded more than plaintext comments.
  • This incentivizes high quality and productive communications around the DAO in the context of completing tasks.

/query

  • this is used to query the stats of any particular contributor. currently this is primarily used to display their registered wallet.
  • in the future we will display other metrics like their "XP", total earnings, repository permissions and more.

disqualifier

  • in a DAO with many concurrent projects being handled, sometimes its difficult to stay on top of everything. frequently DAO contributors will start on a project, removing it from the open tasks list for others to work on, only to not proceed to do any work on it. This blocks progress and its important to monitor project status.
  • disqualifier observes every project for activity in the form of commits and comments from the assignee. if they stop working on the project, UbiquityOS will inquire for an update. If the assignee continues to do nothing, they will be unassigned and disqualified from self assigning on the task again.
  • in the future this will dock the assignees XP or DAO reputation

/ask

  • This is used to ask context aware questions. UbiquityOS reads the linked and other similar content from any conversation within your organization, and then answers accordingly. For example, if the user is on a pull request, we pass in the full pull request conversation, its review, the diff, the linked issue, and any other linked contents we can find from the conversation.
  • This is much faster than pasting in all of the relevant content manually to an LLM

assistive merging

  • advanced configuration to set criteria to automatically merge a pull request. by default this will automatically merge approved pulls after a week.

vector-embeddings

  • Imagine a super manager that remembers everything inputted into your company: for example every comment, message, meeting, and work deliverable. UbiquityOS then has various applications of this super memory:

issue deduplication

  • when contributors create new project proposals, UbiquityOS has the ability to immediately identify similar proposals in the past and which are ongoing and annotate similar parts of the new proposal to indicate their existences. If in general the new proposals are too similar to ongoing ones, they will be automatically closed out and rejected.

task matchmaking

  • UbiquityOS has the ability to understand every project that any contributor has ever worked on. When new projects are created, the system will recommend, in order, of who is best qualified for working on the task. It will also link the previous projects entire work contexts (specification, conversation, work deliverable and work review) for team members to check before reaching out to the contributor.

/annotate

  • automatically annotate any github comment with footnotes/links to related projects or comments. this is useful to reference other related discussions without having to manually search for them.
  • For example, if a project is being discussed by two team members, and they want to review a similar discussion from a previous project, UbiquityOS can immediately recall the original conversation for review. This helps to speed up research and debates as all of the organization's related debates and their conclusions can be summoned, with their full conversation context, on demand.

telegram bridge

  • this provides an integration with UbiquityOS to telegram. When a new project is started, UbiquityOS will create a dedicated chatroom and post it under the GitHub issue.
  • in the future this will allow rewards to be generated for contributor activities that occur within Telegram in association with the project being completed.

@minhyeong112
Copy link
Collaborator

ok great! I'm also bouncing around all day, but can get this done in the timeframe
will take this draft, search for some additional examples, and mix it all into the tg outreach campaign

@minhyeong112
Copy link
Collaborator

/start

@gentlementlegen
Copy link
Member

@minhyeong112 Sorry today GitHub servers are experiencing quite some problems, looking into it.

@minhyeong112
Copy link
Collaborator

/start

@minhyeong112
Copy link
Collaborator

@minhyeong112 Sorry today GitHub servers are experiencing quite some problems, looking into it.

no worries! just tried again for fun

@0x4007 what do you think?
UniquityOS OnePager

@0x4007
Copy link
Member Author

0x4007 commented Jan 10, 2025

Traveling again today so did a quick pass while drinking a morning coffee.

  1. Used ChatGPT to rewrite
  2. Populated in our Google Doc template

https://docs.google.com/document/d/1jWJiW6yMNDoDN5fU6K5GmPIPfn58qYJ_DkJDSHTQfJY/edit?tab=t.0#heading=h.n1oftyayfp1t

@gentlementlegen
Copy link
Member

/start

Copy link

ubiquity-os bot commented Jan 10, 2025

! You do not have the adequate role to start this task (your role is: member). Allowed roles are: collaborator, admin.

@gentlementlegen
Copy link
Member

@minhyeong112 no problem but obviously it is supposed to work, I am trying to monitor this repo closely to see when it doesn't. Don't hesitate to notify me when something goes wrong!

@minhyeong112
Copy link
Collaborator

Updated docs:
UbiquityOS in 1 Minute
UbiquityOS in 10 Minutes

Over to our designer/GreatLeader @0x4007 for approval~
Will integrate these links into the copy as well!

@0x4007
Copy link
Member Author

0x4007 commented Jan 11, 2025

Made some adjustments to the 1 Minute doc.

I was also thinking about the classic advice of "don't sell features, sell a feeling"

Maybe we should have imagery of managers lounging in beachside chairs and emphasizing how much extra time they will have if they use UbiquityOS etc.

image

Check out those toes.

Maybe we can also write more content around "selling the feeling" instead of the features?

@0x4007 0x4007 added good first issue Good for newcomers and removed good first issue Good for newcomers labels Jan 11, 2025
@minhyeong112
Copy link
Collaborator

/start

Copy link

ubiquity-os bot commented Jan 11, 2025

! You do not have the adequate role to start this task (your role is: member). Allowed roles are: collaborator, admin.

@minhyeong112
Copy link
Collaborator

ahh I think I have the wrong permissions here~

anyway, docs have been updated! over to you for approval @0x4007

links copied here for convenience:
UbiquityOS in 1 Minute
UbiquityOS in 10 Minutes

@minhyeong112
Copy link
Collaborator

just made Creating an Issue with Ubiquity OS

if you can add the time stamp (<15 min) and priority to this issue, I can continue to the next videos "Self Assigning Using /start", etc

@0x4007
Copy link
Member Author

0x4007 commented Feb 5, 2025

just made Creating an Issue with Ubiquity OS

Cool thank you! The term we use for "unfunded issues" are "proposals" not that it matters much in the context of the video, but more for you to know when we chat internally. When they are funded we refer to them as "tasks"

@minhyeong112 minhyeong112 self-assigned this Feb 5, 2025
Copy link

ubiquity-os bot commented Feb 5, 2025

Important

  • Reminders will be sent every 1 day and 18 hours if there is no activity.
  • Assignees will be disqualified after 3 days and 12 hours of inactivity.

@0x4007
Copy link
Member Author

0x4007 commented Feb 5, 2025

Is there a reason you did it in that org? You're a collaborator on ubiquity org so you should be able to set labels yourself.

Also sorry I got around to that issue and started debugging before I realized you still need it for the video. My comment might not be great in the video there.

@0x4007
Copy link
Member Author

0x4007 commented Feb 6, 2025

A few more videos. More coming soon.

  1. https://www.loom.com/share/3ffa0284ecbd49f6b021a21ae0b02a1e?sid=f30ab8ad-88f4-43dd-94c0-2b6932edeb37
  2. https://www.loom.com/share/9a065bd99b18455d9314440704b0d0ed?sid=41f0cfe5-95db-4a60-8e80-a580fd537bd8

Seems like you cut yourself off at the end regarding the disqualifier schedule.

  1. https://www.loom.com/share/81d4bb21e2524784b9f8842df184d40a?sid=0fe0b240-df61-44aa-9610-a7aca3bda77a
  2. https://www.loom.com/share/23135043ea354edcb1886ae279b68663?sid=68dfb2e6-f76c-4a50-aa0a-874c29ec05ba

Last one is dope! I guess a lot of people might be impressed by /ask

We should also emphasize the timestamp/date of the videos in their descriptions or titles because things rapidly go out of date.

@minhyeong112
Copy link
Collaborator

emphasize the timestamp/date of the videos in their descriptions or titles

all titles updated to say "(Feb2025)"

Seems like you cut yourself off at the end regarding the disqualifier schedule

please check it out again. I made the ending a bit awkward, so I can also cut it off cleanly right before I say "...also..." if you'd like!

new one below. pending your closing of the issue in the video to proceed with some more videos on claiming rewards (showing the AI reward breakdown too!)

  1. https://www.loom.com/share/7e31bed183fc47429b09b7ea226bc71f?sid=a007fad9-0412-41e6-8ef7-624ff2b037f7

@0x4007
Copy link
Member Author

0x4007 commented Feb 6, 2025

Please assign labels to the "enhance READMEs" issue when you have a moment so that I can make the rest of the videos~

  1. https://www.loom.com/share/3cb42b1845ea492d806510c1225da437?sid=4c0714c2-6f51-454d-8d29-fb9549ee68fe
  2. https://www.loom.com/share/d29f9e6ad33e461080a0143011d168da?sid=610f9e25-1b04-48c9-9749-49d58bfc0ad7

Seems the first two were cut off as well

@minhyeong112
Copy link
Collaborator

Sorry, I used Loom's "cut whitespace" feature, but it seems it was a bit too aggressive. I fixed them and will edit manually going forward.

@minhyeong112
Copy link
Collaborator

Still pending your closing of the issue in the video to proceed with additional videos~

@0x4007
Copy link
Member Author

0x4007 commented Feb 9, 2025

Bad news is that we can't really close as complete until the pulls are merged so can you incorporate the feedback from the pulls?

Also be mindful to not change anything but readmes. Mentlegen mentioned that you changed some code as well.

Copy link

ubiquity-os bot commented Feb 10, 2025

@minhyeong112, this task has been idle for a while. Please provide an update.

@minhyeong112
Copy link
Collaborator

incorporate the feedback

yes, will incorporate now

changed some code as well

went a bit overboard with Cline fixing the pre-checks 😅 will be more careful

Copy link

ubiquity-os bot commented Feb 12, 2025

@minhyeong112, this task has been idle for a while. Please provide an update.

@minhyeong112
Copy link
Collaborator

Would like to complete the video series on this issue just for the sake of completion; I requested reviews for all the latest README updates (sorry for all the back and forth but it was a learning experience for me and should be smoother in the future 😄 )

@minhyeong112
Copy link
Collaborator

minhyeong112 commented Feb 13, 2025

So this is what we have so far, I can make the 9th one once the financier loads up at least 70USD to cover a pending reward that I can accept live for the video. Also plz let me know if you'd like anything else done!

  1. Submitting Proposal
  2. Issue De-Duplication
  3. Talent Recommendation
  4. /wallet
  5. /start
  6. /help
  7. /ask
  8. Commenting / Requesting Feedback
  9. Task Completion and Accepting Payout

@minhyeong112
Copy link
Collaborator

@0x4007 videos complete!

I believe that completes round 1 of educational materials along with this one-page intro.

please let me know if I can do anything else for this task!

Will continuously improve them and create a PR to put it all on the ubq.fi landing page asap

@0x4007
Copy link
Member Author

0x4007 commented Feb 14, 2025

Check the ends of the videos to ensure you didn't get cut off. I noticed that in another one i saw the other day but was too distracted to tell you right away.

What about ten minute doc? Also we should tuck this away in an educational materials section of the site.

Lastly I want to mention again that videos won't work on our notion so let's figure where else to host.

Copy link

ubiquity-os bot commented Feb 14, 2025

 [ 804.8 WXDAI ] 

@minhyeong112
Contributions Overview
ViewContributionCountReward
IssueTask1800
IssueComment24.8
Conversation Incentives
CommentFormattingRelevancePriorityReward
I think the best way to educate others about the features is to …
2.1
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 36
  wordValue: 0.1
  result: 2.1
142.72
ok great! I'm also bouncing around all day, but can get this don…
2.05
content:
  content:
    p:
      score: 0
      elementCount: 2
  result: 0
regex:
  wordCount: 35
  wordValue: 0.1
  result: 2.05
0.842.08

 [ 774.382 WXDAI ] 

@0x4007
Contributions Overview
ViewContributionCountReward
IssueSpecification143.84
IssueComment18730.542
Conversation Incentives
CommentFormattingRelevancePriorityReward
We should develop educational materials that showcase the system…
8.71
content:
  content:
    p:
      score: 0
      elementCount: 1
    ul:
      score: 0
      elementCount: 1
    li:
      score: 0.5
      elementCount: 4
    br:
      score: 0
      elementCount: 1
  result: 2
regex:
  wordCount: 141
  wordValue: 0.1
  result: 6.71
1443.84
Some old ones i have saved for pitching https://github.com/ubiq…
10.59
content:
  content:
    p:
      score: 0
      elementCount: 1
    a:
      score: 5
      elementCount: 2
  result: 10
regex:
  wordCount: 8
  wordValue: 0.1
  result: 0.59
0.5426.66
This is a very rough draft. Normally I would pass it through an …
79.01
content:
  content:
    p:
      score: 0
      elementCount: 31
    h1:
      score: 1
      elementCount: 2
    h2:
      score: 1
      elementCount: 13
    ul:
      score: 0
      elementCount: 18
    li:
      score: 0.5
      elementCount: 37
    h3:
      score: 1
      elementCount: 2
    a:
      score: 5
      elementCount: 1
  result: 40.5
regex:
  wordCount: 1101
  wordValue: 0.1
  result: 38.51
14390.44
Traveling again today so did a quick pass while drinking a morni…
7.44
content:
  content:
    p:
      score: 0
      elementCount: 4
    ol:
      score: 0
      elementCount: 1
    li:
      score: 0.5
      elementCount: 2
    a:
      score: 5
      elementCount: 1
  result: 6
regex:
  wordCount: 23
  wordValue: 0.1
  result: 1.44
0.6423.064
Made some adjustments to the 1 Minute doc. I was also thinking…
8.61
content:
  content:
    p:
      score: 0
      elementCount: 6
    img:
      score: 5
      elementCount: 1
  result: 5
regex:
  wordCount: 68
  wordValue: 0.1
  result: 3.61
0.8435.296
One minute document is nice but longer than a one minute read! I…
3.97
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 76
  wordValue: 0.1
  result: 3.97
0.9418.18
I sent you some feedback to discuss in DM but haven't heard back.
0.94
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 14
  wordValue: 0.1
  result: 0.94
0.341.368
So dao.ubq.fi is just notion I think I added you. If not then le…
12.95
content:
  content:
    p:
      score: 0
      elementCount: 1
    ul:
      score: 0
      elementCount: 1
    li:
      score: 0.5
      elementCount: 2
    a:
      score: 5
      elementCount: 2
  result: 11
regex:
  wordCount: 33
  wordValue: 0.1
  result: 1.95
0.4426.72
### FeedbackHey just had a chance to read. The technical articl…
13.51
content:
  content:
    h3:
      score: 1
      elementCount: 3
    p:
      score: 0
      elementCount: 3
  result: 3
regex:
  wordCount: 239
  wordValue: 0.1
  result: 10.51
0.7447.348
This is a cool video! I just wish you opened up the rewards brea…
22.03
content:
  content:
    p:
      score: 0
      elementCount: 1
    a:
      score: 5
      elementCount: 3
  result: 15
regex:
  wordCount: 149
  wordValue: 0.1
  result: 7.03
0.75485.29
Original specifications which provide a lot of context on those …
11.77
content:
  content:
    p:
      score: 0
      elementCount: 1
    ul:
      score: 0
      elementCount: 1
    li:
      score: 0.5
      elementCount: 2
    a:
      score: 5
      elementCount: 2
  result: 11
regex:
  wordCount: 11
  wordValue: 0.1
  result: 0.77
0.5428.78
Issue deduplication seems that its been disabled @shiv810 rfc an…
6.85
content:
  content:
    p:
      score: 0
      elementCount: 1
    a:
      score: 5
      elementCount: 1
  result: 5
regex:
  wordCount: 31
  wordValue: 0.1
  result: 1.85
0.4413.904
After we get all the educational materials ready to go I'm very …
3.75
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 71
  wordValue: 0.1
  result: 3.75
0.8414.496
Cool thank you! The term we use for "unfunded issues" are "propo…
2.45
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 43
  wordValue: 0.1
  result: 2.45
0.242.392
Is there a reason you did it in that org? You're a collaborator …
3.11
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 57
  wordValue: 0.1
  result: 3.11
0.243.12
Seems like you cut yourself off at the end regarding the disqual…
2.73
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 49
  wordValue: 0.1
  result: 2.73
0.344.188
Seems the first two were cut off as well
0.65
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 9
  wordValue: 0.1
  result: 0.65
0.341.02
Bad news is that we can't really close as complete until the pul…
2.45
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 43
  wordValue: 0.1
  result: 2.45
0.242.432
Check the ends of the videos to ensure you didn't get cut off. I…
3.92
content:
  content:
    p:
      score: 0
      elementCount: 1
  result: 0
regex:
  wordCount: 75
  wordValue: 0.1
  result: 3.92
0.345.844

@0x4007
Copy link
Member Author

0x4007 commented Feb 14, 2025

$20 for a link and $79 for list items due to the 4x multiplier seems awfully high for me

@gentlementlegen i wonder if it's a bad idea to exclude specific html tags from priority multiplier. That way, links are always $5 etc.

Then we have three properties:

  1. Counting words enabled
  2. Reward amount
  3. Priority multiplier enabled

We also should default list item reward to 0.1

@0x4007
Copy link
Member Author

0x4007 commented Feb 14, 2025

@gentlementlegen RFC

Also calculation looks incorrect for this one #109 (comment)

Unless it's readability score silently adding points but it should only deduct points.

I should've received something close to $20 not $25

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: Done
Development

No branches or pull requests

3 participants