EDev FAQ
Okey-dokey, here are some FAQs for those in the edev usergroup. You, Guest User, are not a member of the edev group here, on E2. In this FAQ, "I" is N-Wing.
First: All E2 development is driven out of Github. Anyone there can spin up a development environment, see how it works, submit pull requests, or ask for features that they can work on. There's plenty to chip in on. Check out the open issues and feel free to start contributing.
Questions:
- What are some of my superpowers?
- Why are random people sending me private messages that start with "EDEV:" or "ONO: EDEV:"?
- What is the background of edev and it's relationship to the development of the site/source?
- What is this "Edevify!" link thingy I see in my Epicenter nodelet?
- Does everybody have their own Everything site for hacking on?
- What is an edevite?
- What is an Edevdoc?
- Why did others (or, why should I) join the edev group?
- How do we go about finding tasks here? If we have personal projects for the improvement of E2, what is the appropriate way to get started? Should I verify that what I'm thinking of is useful, or should I make it work and then submit source patches?
Q: What are some of my superpowers?
A: I wouldn't say superpowers, just powers. Anyway:
- You're a hash! (in the Other Users nodelet, edevites have a
%
next to their name (which is only viewable by fellow edevites)) - You can see the source code for many things here. If you visit something like a superdoc (for example, this node), if you append
&displaytype=viewcode
to the URL, it will show the code that generates that node. When you have the Everything Developer nodelet turned on, you can more easily simply follow the little "viewcode" link (which only displays on nodes you may view the source for). For example, you can see this node's source by going here - You can see other random things, like dbtables (nodes and other things (like softlinks) are stored in tables in the database; viewing one shows the field names and storage types) and theme (a theme contains information about a generic theme).
- You can see/use List Nodes of Type, which lists nodes of a certain type. One example (ab)use of this is to get a list of rooms. nate in Edev First Post! (doesn't that sound like a troll title?) lists some other node types you may be interested in. Actually, you should probably read that anyway, it has other starting information, too.
- You have your own (well, shared with editors and admins) section in user settings 2. (As of the time this FAQ was written, there is only 1 setting there, which is explained in the next question.)
- You can Edevify things. See the later question for more information about this.
Q: Why/how are random people sending me private messages that have '(edev)' in front of them?
A (short) : They aren't random people, and they aren't sending to just you.
A (longer) : When somebody is a member of a usergroup, they can send a private message to that group, which will then be sent to everybody in that group. In this case, those "random people" are other people in the edev usergroup, and they're typing something like this in the chatterbox:
/msg edev Hi everybody, I'm Doctor Nick! Have you seen EDev FAQ yet?
and (assuming the other person is you), everybody in edev would then get a message that looks something like:
Q: What is the background of edev and it's relationship to the development of the site/source?
A: Edev is the coordination list for development of Everything2.com. It is used for discussion of new features or of modifications, or to help people debug their problems. Some code snippets people have written as part of edev have been incorporated into the E2 code here. The main way this happens is by creating Github pull requests.
Q: What is this "Edevify!" link thingy I see in my Epicenter nodelet?
A: This simply puts whatever node you're viewing on the edev (usergroup) page. About the only time to use this is when you create a normal writeup that is relevant to edev. Note: this does not work on things like "group" nodes, which includes e2nodes; to "Edevify" your writeup, you must be viewing your writeup alone (the easiest way is to follow the idea/thing link when viewing your writeup from the e2node).
Q: Does everybody have their own Everything site for hacking on?
A: Yes! Everything has a development environment that is powered by Vagrant and VirtualBox. Starting up your very own copy of the environment is as simple as installing a couple of pieces of software, cloning the repository, and typing "vagrant up".
Q: What is an edevite?
A: Instead of calling somebody "a member of the edev group" or "in the edev (user)group", I just call them an "edevite".
Q: What is an Edevdoc?
A: The Edevdoc extends the document nodetype, but allows edevites (and only edevites) to create and view it. They are primarily useful in testing out APIs and writing Javascript pieces to test out new interfaces and functionality. You can also do it entirely in the development environment as well.
Q: Why did others (or, why should I) join the edev group?
A from anotherone: I'm in the group because I like to take stuff apart, see how it works. Understand what's going on. I've had a few of my ideas implemented, and it was cool knowing that I'd dome something useful.
A from conform: I'm interested (for the moment) on working on the theme implementation and I've got some ideas for nodelet UI improvements.
A from N-Wing: I originally (way back in the old days of Everything 1) had fun trying to break/hack E1 (and later E2) (hence my previous E2 goal, "Breaking Everything"). Around the time I decided to start learning some Perl, the edev group was announced, so I was able to learn Perl from working code and find more problems in E2 at the same time. (However, it wasn't until later I realized that E2 isn't the best place to start learning Perl from. :) )
Q: How do we go about finding tasks here? If we have personal projects for the improvement of E2, what is the appropriate way to get started? Should I verify that what I'm thinking of is useful, or should I make it work and then submit source patches?
A: Generally, feel free to post a message to the group or open an issue on the page.