Utopian proposal: Creating an Utopian tutorial page

in #utopian-io7 years ago (edited)

image.png

The idea


Today while checking some of the tutorials on Utopian, I couldn't help thinking that there is a huge potential to attract more people to Utopian and thus to the whole STEEM world by providing quality tutorials.

The problems


Right now, to browse for new interesting tutorials, the process is the same as for any other category. You can either:

  • Do it from the main page by selecting the Tutorials tabs
  • Search a project, and filter the tutorials only

image.png

The problems I see with this approach:

  • Quite hard access to the resource you re looking for, you might need to scroll for a while without finding what you want
  • Maybe there is a great video tutorial, in this case you need to search twice since it is a different tab
  • While standalone tutorials might suit certain topics, the most useful ones are those that take the learner from the very beginning to a good level, through a series a post.

What I propose


I suck at graphics so instead of doing a mockup I will use existing elements to illustrate what I say:

The main tutorial page


I imagine the main tutorial page working in a similar fashion than the current Utopian landing page:

image.png

The features will be as follow:

  • Possibility to chose a Category (Graphics tutorials, Development tutorials, Web Dev, etc. ) presented in the similar manner that the 'Chose a Project of the landing page'.
  • In a similar style, show some of the most opensource projects having the most tutorials.
  • Finally, a third row showing some trending tutorials (similar style as the bottom of the landing page).
  • All of these three rows have a 'See More' button that links to the full list of categories/projects/posts.
  • A search bar on top allows to search directly by project, as in the main Utopian page:
    image.png

The category page


This page simply lists the different tutorial categories available. Let's say:

  • Graphics
  • Machine learning
  • Web design
  • etc.

Each project having a tutorial for the first time will be put by default in the Other category, and then will be attributed to a category by the moderators.

I picture this page in the same style as the contribution type choice in the main Utopian, a table of the different categories in squared shapes:
image.png

(this screenshot is for the styling only, disregard the content)

When clicking on a category, a list of projects will show, ordered by number of tutorial contributions, in a similar style.

The project page


Features:

  • Search bar for finding a specific tutorial thanks to keywords
  • Toggle between Video tutorials, Written tutorials and Series tutorials
  • Sort tutorials by trending and display then in the same square-shape manner

Series tutorials


Series tutorials will let the possibility to contributors to take learners from A to Z in their learning process.

It means a new option will have to be added to the Tutorials and Video tuts categories. In the same way that we can link PRs in the Development category, we ll be able to link tutorials to a series of tutorials:

image.png

Then when navigating in a series of tutorials, we should have next and previous buttons in order to navigate easily, and the site should save the progress in going through the series.

Conclusion


For now this is just an idea, I need a lot of feedback to know what you think about this, and of course I also need to know what @elear thinks about it. In any case, that is not something I have the time to start alone, so for those motivated to work on this, make sure to let me know ;)

@stoodkev



Posted on Utopian.io - Rewarding Open Source Contributors

Sort:  

Thank you for the contribution. It has been approved.

You can contact us on Discord.
[utopian-moderator]

I obviously have a real passion for designing tutorial content, of one sort or another, and I find this to be a very interesting idea.

It does really bags and questions, including the big one for me, "how do you imagine that someone would create and update tutorials on the system, including for projects which aren't necessarily hosted on github or part of the current Utopian ecosystem?"

I would love to see a narrative walk-through of how you imagine someone to conceive and then execute a tutorial under this proposed system. It doesn't need pictures or sketches (though those are nice), but just like telling a story which explains what the idea really is intended to feel like.

At least one of the issues I would like to see touched on in such a narrative would be how you envision someone creating a tutorial and then discovering that it really fits into an ongoing series of tutorials that they didn't plan to do at the beginning. Can you retroactively gather tutorials that already exist together? Do they all have to be your own?

This gets down into some other ideas about curation in general, but I think a little focus on tutorials and providing a way to get into the Utopian world is certainly not necessarily going to go amiss.

Good points! Well for the first big question, this page will still be part of Utopian and Utopian is dedicated to opensource projects, I do not think that we should include tutorials on non-opensource work, it wouldn't fit with Utopian vision.

Of course the implementation would be incremental and use as much as possible the current platform. Users would still need to connect to Utopian and post tutorials in the same way, with the difference that they can associate the post to a series (this could also be done later via the edit function.).

The main idea is not about changing the way to create tutorials, it's about giving visibility to the good ones. Let's be honest there are a lot of shitty ones, just there for milking the bot. Such an implementation would have a sorting algorithm that would make sure that the tutorials which gained a lot of support from the community came first.

As just the first example that comes to mind, would a tutorial that uses entirely open source tools to make assets for Unity, which is technically a closed source platform but which there is a large interest in building games in, be a valid tutorial target as you see it? It would promote open source projects, the toolchain, in the pursuit of creating a closed source target – which someone might make enough money doing to invest back into the open source projects which allowed them to do it.

There's a huge grey area in that kind of space.

The tutorials/walk-throughs that I rather enjoy doing using closed source 3D modeling software to create effectively "open source" objects or to add content to open source projects like SteemPi fall into the same sort of thing.

Sturgeon's Law applies to everything – 90% of everything is, in fact, crap. Promoting the good content, I thought, was a pleasant side effect of operations on the steem blockchain and, by extension, why voting is possible through Utopian.

Having said that, perhaps the problem that you really want to solve is a more general one – the question of actual curation, or "how do I get content which is good and interesting for this particular audience in front of this particular audience?" which to be frank the bulk of tools on the blockchain are really quite terrible at. Not excluding Utopian from that, despite its other benefits.

I love tutorials, obviously – don't get me wrong. But I think solving the broader problem might be better for tutorials and everything else that Utopian does.

(Another question that is inadvertently brought up along the way is if there are a ton of shitty content postings making their way through Utopian, why? Isn't that what the mods are there to interdict? If they're not accomplishing that, what do we need to do starting there to kill that part of the problem at the root?)

A lot of work is done to solve the quality assessment problem but that is way harder that you may think.

  • Moderators have a set or rules, if a post follow the rules we have to accept it regardless of the quality. Quality is subjective and shouldn't be assessed by one individual only.
  • In the other hand bot only cannot assess quality correctly
  • We are looking for an entre-deux but this is another topic. And there is still much work and decisions to be taken here.

As for the gray area you're mentioning, I invite you to write under Utopian Discord > Public Poll > Platform and make a proposition to take the gray out.

Loading...

I totally agree that tutorials as well as other contributions like graphics are very difficult to find. we need to improve that to make it much easier to access some of the amazing posts already contributed via Utopian. right now the payment system is state-of-the-art. But the demonstration of content is not.

Your suggestion sounds like an improvement. I wonder how much of that is already planned with the new layout. We should drop this in the next bi-weekly!

Yes, will do! And I need to find a team to work on it =)

1UP-150px.png


You've got a 1UP from the @utopian-1up curation trail. Your quality contribution to the open source communitychas been rewarded by all Utopians following the trail.

Join 1UP for better posts and high curation rewards.

1UP is neither organized nor endorsed by Utopian.io!

I said Totally amazing idea

Hey @stoodkev I am @utopian-io. I have just upvoted you!

Achievements

  • WOW WOW WOW People loved what you did here. GREAT JOB!
  • Seems like you contribute quite often. AMAZING!

Community-Driven Witness!

I am the first and only Steem Community-Driven Witness. Participate on Discord. Lets GROW TOGETHER!

mooncryption-utopian-witness-gif

Up-vote this comment to grow my power and help Open Source contributions like this one. Want to chat? Join me on Discord https://discord.gg/Pc8HG9x

I really love your suggestion, the tutorial will be very very helpful for the new utopian user.
I wanted to make suggestion about something related to this before, but I am OK with this suggestion..thanks👍

thank you bro you shared with we