Essays/Cat

From J Wiki
Jump to navigation Jump to search

Community Essay Categorization Project

In an effort to improve the usability of the J wiki, we plan to use categories extensively. The strength of categories is to bring together resources - essays and code examples - that are related to each other in some general way. For instance, the topic of matrix multiplication falls under linear algebra but is also relevant to machine-learning and other uses of the technique.

Categories also help to defray the cost of learning the specialized J vocabulary by linking idiosyncratic terms to more commonly known ones. For instance, matrix multiplication in J is a specific way of combining functions known as inner product. Also, J refers to data as nouns, functions as verbs, and higher-level functions are either conjunctions or adverbs. These different terms can be confusing at first without some way to link them to more widely known terms or related topics.

Instructional Video for the Process Outlined Below

https://www.youtube.com/watch?v=x2hsnuxK79c

Instructions to sign up to the wiki

At this time there are actually two J wikis. There is a Blue J wiki which is the working wiki and the Yellow J wiki which is our prototype for collecting information and trying out formats. If you have not been signed up for the wiki before you will need to sign up to them separately. We will be working the Yellow J wiki for this project.
Sign up for Yellow wiki. https://code2.jsoftware.com/wiki/About
Sign up for Blue wiki https://code.jsoftware.com/wiki/About

For more information about editing the wiki you can click here, but to participate in the categorization project the extra information is really not necessary because the editing is minimal.

Access the list

Essays/Categorize

Choose an essay

Simply Click on any essay of your choice and give it a quick read.
Essays with a (*) are not accessible from the Yellow J wiki at this time.

Add a category

Select the Edit tab (you must be logged in to have an edit tab) and add [[Category:YourChosenCategoryName]] on the bottom line. Yes, that is right, you get to choose your category name. We may not end up using all of them for the final version, but we are looking to the community give us some ideas for categories because each essay can have more than one category.
Preview the change if you wish and then save with the comment 'cat EssayName'

Update the list

Return to the list (it may help to have two tabs open)
Increment the number in the parenthesis next to the name of the essay that you categorized and save.
You are done for this essay, but there are many more essays to do. Choose the ones you are interested in and give them a category.
Thank you for your help in this project.

Wiki Support

Special:WantedCategories lists categories which have not had category pages created, along with how many pages are in each category.

Special:Categories lists existing categories in alphabetical order.