Skip to content

Updated Doc Content, styling code blocks #279

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

Open
wants to merge 6 commits into
base: dev
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 36 additions & 9 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,40 @@
# ⚠️ under construction ⚠️
(we're still in the process of updating all the old docs && migrating them from the [old wiki](https://github.com/netizenorg/netnet.studio/wiki) if you can't find what you're looking for here, it might still be over there.)
### netnet.studio is an open-source hypermedia cyberspace for fully realizing the Web’s creative potential.

netnet's goal is to guide creatives in their journey, from curious beginners to creative code virtuosos, through interactive learning and experimental play with the medium itself. Our mission is to help artists, designers and other DIY makers reclaim the Internet as a hand-crafted space for self-expression.

![banner](readme-banner.png)
<div id="donate-links">
<a href="contributors/support.html">Donate 💰!</a>
<a href="contributors/index.html">Donate ⏰!</a>
</div>

## Welcome netizens to the netnet.studio docs!
Here you'll find general info on what netnet is and how it works, as well as guides for how to help support and contribute to the netnet.studio repo!
<p class="center italic">
netnet.studio is a free/libre open-source project please <a href="contributors/support.html">consider supporting it</a> to keep it alive!
</p>

- [I'm a student and want to learn how to use netnet.studio!]()
- [I'm a teacher and want to learn how to use netnet in my class!]()
- [I'm a developer and want to help contribute to this repo!](developers/README.md)
- [I'm an advocate and want to help support this project!](advocates/README.md)
# Meet netnet ( ◕ ◞ ◕ )

When you visit netnet.studio you'll be greeted by a friendly artificial intelligence teaching assistant (AI-TA) named netnet! As an AI-TA, netnet supports students of the Web by explaining code fragments, encouraging best practices, and correcting common mistakes. However, in these AI-times it's worth clarifying that netnet is not a "large language model" or any other kind of "machine learning", *it* (preferred pronoun) is a human-authored *classical AI* system, less like a corporate chat bot and more like the AI in a retro video game. Every word has been carefully considered and written by humans (that's us), therefore netnet will never "hallucinate" nor will it write all your code for you (though it will help with a snippet here or there).

We're not entirely opposed to LLMs, we believe there's lots of unexplored possibilities in the ethical and artistic application of "artificial neural networks" (we're currently working on creative AI/LLM literacy tools and lessons). However, we do feel that the way they're currently being integrated into coding tools is designed more for "people who think to make" (folks with ideas they want someone or some*thing* to make for them) and less for those who "make to think", meaning those of us who discover, learn and grow our creative ideas through the process of making and writing code ourselves.

**If you're an aspiring student of the creative web, [start here](students/README.md)!**

# The Platform

The [first web browser](https://www.youtube.com/watch?v=3c3Rt6QbHDw) was both a tool for exploring the web and creating it. The first browsers were all research projects created in labs and universities, but when enterprising technologists saw its commercial potential they removed the "editor" part and left only the "browser" part. netnet brings the "editor" back into the "browser", where it was always meant to be.

Unlike most web-based products of [surveillance capitalism](https://www.youtube.com/watch?v=hIXhnWUmMvw) (the dominant business model of big tech today) netnet.studio is not here to collect and profit off your data. The studio is carefully designed to be a privacy-focused safe space for creative experimentation (You can read our [privacy policy](https://dev.netnet.studio/?w=privacy-policy) at the studio). While netnet is modeled on modern code editors and does integrate with other third party tools like GitHub (for the purpose of teaching others the conventions and tooling of the day) we go to great lengths to make this all secure and extremely transparent while remaining accessible.

**TODO** *update privacy-policy dev link to main link before pushing to main*

**If you're an educator interested in leveraging the platform in your classroom, [start here](educators/README.md)!**

# Our Mission

What begun as a research project in computer networking in the late 1960s slowly grew into a globally distributed network of networks called the the *Inter*net. For the first couple of decades, using the Internet meant reading and typing into text-only displays. That is until the early 1990s, when a small group of scientists, taking inspiration from an experimental [media art/tech scene](https://archive.org/details/HyperlandBBSDouglasAdamsAndTomBaker1990), added a "hypertext" and "multi-media" interface called the World Wide Web. Like the physical infrastructure it was built on (the Internet) the Web reflected a set of values which enabled it to grow far beyond its inventors wildest dreams!

Today, the Web's core values of openness, transparency, decentralization, accessibility, extensibility and interoperability have been slowly eroded by the profit-motives of greedy tech corporations which have colonized and privatized what was once an entirely public commons. This industry and its "[merchants of complexity](https://world.hey.com/dhh/merchants-of-complexity-4851301b)" will have you think that creating web sites and apps requires advanced skills and expensive infrastructure and that the only way to have a presence online is to either become an expert (the industry has always been guarded by a sort of "[priesthood](https://www.newmediareader.com/book_samples/nmr-2nelson.pdf)") or succumb to "posting" on *their* websites.

But this re-writing of history could not be farther from [the truth](https://coolguy.website/introduction/). The Web was designed to be [hand-crafted](https://luckysoap.com/statements/handmadeweb.html) by anyone interested enough to take the time to learn a few basics and indeed, [in the early days it was](https://www.youtube.com/watch?v=2LzyRcLJdlg). While we're inspired by the hand made web of the 1990s, this project is not about nostalgia, netnet.studio encourages others to explore (and is itself created with) modern and cutting-edge web technologies. The Web has never had more creative potential and netnet.studio is a platform to help you decide [what the web of tomorrow should be](https://laurelschwulst.com/e/my-website-is-a-shifting-house/)!

**If you believe in our mission and what to help contribute time to the project, [start here](contributors/README.md)!**
51 changes: 0 additions & 51 deletions docs/advocates/README.md

This file was deleted.

Loading