Tupper has been posting asking for ideas for an official VRC wiki, figured to post this here for people not on Twitter
Addendums:
Tupper has been posting asking for ideas for an official VRC wiki, figured to post this here for people not on Twitter
Addendums:
One other thing to note: the license of the wiki is being potentially reconsidered from the proposed one after discussion with another user:
Yeah, i saw those posts online. Being able to update it community wise is a good thing. I don’t really have much to say, not having a lot of experience making wikis myself.
Maybe more a question than a suggestion, but what would be the limitations of this wiki, for example on community projects. Having documentation on how to integrate with the major community tools or framework. It’s still technically VRC related, but not directly to the game.
Would this have it’s place on this wiki as it would be community driven, or is the main direction to have our own wiki/docs somewhere else ?
Edit: Tupper agrees https://x.com/dtupper/status/1785064208473694587
The community should be able to participate in a major way!
Dokuwiki has a feature called namespaces. This makes it relatively each for the community to have their own dedicated space on the wiki.
For example, the community could create community:cheese_guides:how_to_get_cheese
without needing to create their own VRRat lore wiki.
Long time editor from the unofficial VRChat Legends Wiki here. I used to be very active in the past but the workload got too huge and I had to take a step back. Nowadays I mostly moderate and resolve disputes.
Any wiki that isn’t Fandom with an open license that clarifies that contributed writings are being “gifted to the community” should be decent. Fandom is a for-profit company that has a lot of flaws, is riddled with ads and enforces poor design choices. If I could go back and do things differently I would never have chosen Fandom. If I had the financials to migrate it and self host instead I would also have done so.
The MediaWiki CMS has a lot of established plugins which most wiki editors will already be familiar with. It is a lot more customizable to use rather than DokuWiki and will scale well with hundreds of active editors while DokuWiki will have many growth problems. Mediawiki is used by the largest and most iconic Wiki - Wikipedia. There are a huge selection of plugins and template themes for MediaWiki for adding additional features, for example custom permissions that allow only certain editors to edit certain pages, syncing content with other databases and more. No need to re-invent the wheel so to speak. A lot of features can be configured instead of re-developed inhouse.
I’m mostly writing this at the top of my head so apologies if its not the best formatted or structured.
Some key things that would be helpful:
What should the Wiki be - and what shouldn’t it be?
Important topics to iron out regarding moderation of community wikis:
The most common disputes on VRChat Legends are from inexperienced authors with (mostly) good intentions who end up not understanding what Wikis actually are. Many mistake them for microblogs like social media where you can type whatever you wish instead of public documents that anyone can edit that require good faith and integrity in order to do so. Especially when writing about other users or other their communities. More editors will want to exaggerate, sound overly flashy and “cool” instead of writing text that is useful and accurate.
It should be very clear when registering that:
These are some things I could think of right now. Here are the VRChat Legends community guidelines that have developed over time here that may be helpful for reference. They’re unfortunately due for a rewrite and not written in any kind of formal or legal speech at all.
Hopefully this is helpful in some way for you to determine how to go ahead with this. Feel free to reach out to me on Discord. Same username “Cragsand” there.
Best Regards
Crag
Thank you for the post! This is excellent information, and I’m really glad someone who worked on that wiki is present in the conversation.
A lot of your advice hits home on my thoughts. Summarising a bit, I think that establishing a clear, narrow purpose to start makes the most sense and solves many problems, and we can expand with new namespaces if we see a need arise.
I want to focus initially on two main things:
Despite users asking for “lore” and “history,” that’s not what our official wiki is for. Agreed on that front.
This is all excellent advice. I want to keep the SSO requirement for various reasons, including hopefully a future way to let users show off that they’re contributors. The 24-48 hour delay for first login sounds great.
I wanted to go with MediaWiki to start, but got a good amount of push-back internally with previous MW administrators citing pain with its tech stack and integration. That’s why we went with DokuWiki.
Do you think DokuWiki is enough of an issue that we should reconsider at this early point, rather than later on when we have to do a bunch of manual work to migrate?
Quick correction: Wikipedia utilizes Mediawiki, not Dokuwiki.
I definitely think there should be VRChat linking, I imagine the majority of the people utilizing the wiki will have a VRChat account, whether they actively use it or not. I think it’ll definitely help in terms of accountability imo.
I do wanna throw my hat into the discussion here and repost some thoughts I talked about with other people:
I feel like definitely lore pages should be closely monitored, you don’t want anybody sitting there and just shoving their world or themselves in there for advertising’s sake and not for anything actually meaningful people will want to read.
With all three here the biggest reason is that I worry people will just make pages to advertise their groups without a lot of substance and such and end up being clutter
For clarification I meant that MediaWiki is used by Wikipedia, not DocuWiki. Apologies that this was misunderstood. I typed the sentence weirdly. Edited. @TrixxedHeart
I don’t have enough experience working with databases to say for sure when either is preferable to use but as far as I know if you write to files directly it may cause problems. For example if writes happen simultaneously in different asynchronous processes, like multiple read/writes from an Apache HTTP server, you may get an error in a text file but not using a dedicated database like MySQL/MariaDB. I also found a plugin for DocuWiki to use a local sqlite database but this seems very vulnerable to sudden lack of future updates.
This kind of design with files is fine for small and personal wikis but not recommended for speed or scale when a website has hundreds or thousands of simultaneous users. There may be tools to import those text files into mediawiki but since the formatting markup i.e. “wikicode” is different between the two any conversion would need to be translated so it will not be an easy seamless translate without manually reviewing it. Maybe with AI but that’s not something I’d rely on. So using DokuWiki even if it may be simpler you may be painting yourselves into a corner.
MediaWiki database structure:
https://www.mediawiki.org/wiki/Manual:Database_layout
DokuWiki database structure (or lack thereof):
https://www.dokuwiki.org/faq:database
Tl;dr. I recommend MediaWiki.
Honestly, all things considered, I’m leaning pretty heavily to not allowing “lore” content to start. I think the Legends wiki serves that purpose just fine.
Later on, there might be some interesting history or context to document, but to start I have a pretty narrow set of things to nail.
Good to hear, it should start focused and aim to serve its niche well rather to attempt to do many things at a lower standard.
Hope the NC licensing issue has been considered further. I think NC must be stripped, but absent any willingness to budge on that, please patch the deficiency in what, for the purposes of the license, you will define as commercial use - both acceptable and unacceptable uses, in spirit. I imagine you wouldn’t want someone to publish the wiki as a book in a non-transformative way and sell it, but you might not be interested in demonetizing a content creator producing a useful video tutorial series on YouTube based on the content of the wiki.
For that matter, it would also help to offer guidelines on what is considered a derivative work; practically speaking, those are the two major ambiguities. Useful code snippets (or Udon graph examples) embedded inside wiki articles being MIT licensed or Public Domain (or the required license that confers similar terms, as PD isn’t treated the same everywhere) would remove one of the most significant concerns, for example.
After a bit more discussion, we’ve concluded that the NC clause will stay, meaning we’ll be going with CC Attribution-Noncommercial-Share Alike 4.0 International. The reasoning for including includes us not wanting people to straight up reprint our work and monetize, along with other protections.
The issue then comes down to a “trust me, bro” problem, right? We know we wouldn’t go and request a takedown for someone quoting portions of our wiki, using knowledge from it, or screenshots of it in a monetized YouTube video, but you don’t know that, partially because “commercial use” is (intentionally) fuzzy.
We recognize these concerns and understand where you’re coming from. Where it makes sense and is compliant with understanding and meaningful licensing, we’ll make clarifications – but generally, the text of CC BY-NC-SA 4.0 will apply.
As a side note, we did not choose a “ND” license intentionally, as derivative creations are perfectly fine and help protect some of the content we’re talking about.
With that settled, our next steps are as follows:
Our ETA for launch is the end of June, but this may change depending on team load.
It comes down to there being no bright-line definition of “non-commercial”, and legally un-settled questions about what constitutes “derivative work”. “Trust me bro” is related but not exclusively the issue.
What I’m looking for, then, given that NC will stay, is
I want to underscore that while I can’t imagine that you/the company as it exists now would go after small creators, I think is far from inconceivable that your eventual successors might not be as averse to pursuing damages against parties who have made significant revenue in a related sector.
As an update, after a lot of internal discussion and risk-checking, we’ve moved the content of the wiki to CC BY-SA 4.0:
We’ve also considered alternatives to DokuWiki, like MediaWiki or a managed host (wiki.gg is a contender, for example). However, we want to keep things in-house if possible.
Thankfully, if that turns out to be a bad choice, migration isn’t too terrible.
Our next steps are to contact some community members who have experience running wikis and wiki-like things and invite them to both the wiki and a discussion space on Discord so we can get their feedback and thoughts.
Good to see!!! That was one of my only major worries.
I think Dokuwiki will probably be fine, although Mediawiki might have some more support in terms of plugins which I’d consider looking into. Especially with the likes of TemplateStyles being useful for creating more robust and clean templates for users to use for specific things along with making templates more lightweight (as it makes it so only the CSS associated with that template is loaded when that template is actively used).
I’m not sure if Dokuwiki has an alternative or something like that is already built in, but should possibly be considered.
Excellent! Thank you for the update, and thank you for listening!
For transparency, the main issue with MediaWiki is that setting up and running our own instance is, to put it lightly, a huge pain in the butt.
We have a few team members that have had long-term expert-level involvement with running MW instances at scale, and I’m fairly certain I saw them having flashbacks when I mentioned considering MW.
Hey y’all, here’s where we’re at.
We’ve been trying to dedicate time to putting more of our Readme content into the wiki as a starter, but we’ve been struggling to find time to do so. Both our Creators and Community team are maximally resourced (as in, we’re swamped) so while I understand why we’ve been laggy, I’m also sad because I’m personally very invested in getting this out to everyone.
As such, I have a proposal: I’d like to open up the wiki to key contributors first.
You would be a volunteer that we would work with to help build the foundations of the wiki and establish the core content. Ideally, I want you to grow into Wiki Mods, who are community members with the power to help us grow the information there in an organized, mindful way. You will have ownership over many parts of the wiki and will collaborate closely with the VRChat team on official segments of the wiki.
The wiki would open for viewing right away, but we wouldn’t promote or link to it until we have a decent amount of content.
As such, I’m putting out this form for those interested. Those who participate and remain active will receive recognition in the form of anything else we can think up to help you show off your hard work to others.
Thank you!
edit: Modified the items in the recognition.
Hmmmmm, maybe.
Question: This question is super open-ended. Is that intentional?
There’s a lot of caveats I think. Example: as a user, contributor, or maintainer? And are these websites/things that have a wiki, or the actual software they use?
Edit: I ended up assuming it was software