Item:OSW3d31fba2cdab4da0aa7de038df8bd96d: Difference between revisions

# If you have an ORCID as a researcher, then you can use that to set up your account. Your ORCID will become your username

==== How to change your user page from your ORCID: ====

# Click on the three dots on    the right-hand side of the page.

# Click on Move Page.

# Enter the desired name of    your user name.

# Click Move page.

==== How to make yourself a User entity in the Battery KB (not the same as above): ====

#Fill in the parameters where relevant and required.

# Save your entity and starting using it! You can now essentially tag or define yourself in relation to other objects. For example, try finding your Battery 2030+ project and adding yourself as a Member to that project.

 

==== How to add your User entity to a project: ====

## '''Edit''': this allows you to modify the information displayed on the project's entity page.

# Click on Edit data and scroll down to find the Member info box.

## Troubleshooting: if you can't find your name, that means you didn't create yourself as a User entity first. You need to do that before adding yourself to a project. No, you cannot simply type in your name for now (you will learn how to do this later).

==== How to add your User entity to an organization: ====

You can add yourself to an organization (typically, your employer but also other types of organizations like workgroups or research groups like Battery 2030+). But this is done differently from a Project.

# Find your organization. You can use search or this Category: [[:Category:OSW1969007d5acf40539642877659a02c23]]

# Click on that Project's name to find their entity page.

# Click on Edit data and scroll down to find the Member info box.

# Type in your name in the search box and click on the right entry from the search suggestions.

# Finished!

# Troubleshooting: Should you use Member vs. Member Of? What's the difference?

## '''Member person(s)''': if you want to associate yourself or your institutional affiliation with a Project, note that you go to the Project and Edit data there, '''not''' Edit data on your entity. [Actually, does it matter?]

## '''Member Of''': if you want to associate yourself to your institutional affiliation, you edit your entity page. If your organization belongs to a larger organizational unit, then you edit your organization's entity page. If you put the organization as a '''Member Of''' the project (this shouldn't be allowed anyway, but you may be confused as to why), it means your project would own your organization (which probably isn't true).

## In summary, Projects add members to ''their'' data, but Users add affiliation to ''their'' data.

## Ontologically speaking, it shouldn't matter and the properties should go both ways.

So you've created an entity or two under the pre-existing Categories. Great. But maybe you had some trouble putting in entities that don't exist yet because this wiki is in its early stages of creation. Let's say you want to add your organization and you found it doesn't exist in [[:Category:OSW1969007d5acf40539642877659a02c23]] yet.

# First go to the Category and click + Create at the top.

## A new field box named "Short name(s):" is now in the Data-Editor window.

## Click on the + to create an entry in this parameter and type in the acronym/short name of the organization.

# Let's say you want to type in the country of your organization in the Country field, but the country doesn't exist as an entity in BatteryKB yet.

# Finished!  

 

 

# If you've never edited    Wikipedia before or worked on any other kind of wiki, reading the    introduction and basic five pillars of this page are extremely helpful to    understanding what a successful wiki culture requires: {{Template:Viewer/Link|page=|url=https://en.wikipedia.org/wiki/Wikipedia:A_primer_for_newcomers|label=https://en.wikipedia.org/wiki/Wikipedia:A_primer_for_newcomers}}.

# In essence, Wikipedia has    already developed processes and procedures that solve a lot of common    problems and the BatteryKB doesn't need to reinvent the wheel (at least,    completely).

# One of the best aspects about wikis in general is that you can learn nearly everything by simply copying what you see in a good page. However, this is more difficult in the BatteryKB due to how its ontological structuring.

# If you have worked on Wikipedia or another wiki, you will find that the BatteryKB operates differently. This is because the BatteryKB is built fundamentally on an ontological infrastructure. This means essentially that '''everything''' is classified as a categorical object with defined relationships to other objects, and ''nothing'' should exist outside of this framework.

## Example: if I wanted to create a page for myself in Wikipedia, I would create an article called Samson Y. Lai, and then write my biography and click Save. However, unless another Wikipedia article links to my article or vice versa, my article would essentially be {{Template:Viewer/Link|page=|url=https://en.wikipedia.org/wiki/Wikipedia:Orphan|label=orphaned}} and difficult to find except by explicit search. A person or bot editor would also later need to manually add Categories, such as "Person" and "Scientist" and "American", which can be difficult to assign or define after the fact.

## Conversely, in the BatteryKB, to make a page or rather "entity/object" which represents me, I go the the pre-existing Category called "Users" and create a new User. This User object has pre-defined parameters, such as name, role, location, and relevant relationships to other objects (e.g., Institutional Affiliation). In this way, the parameters are consistently used by all objects (no issues of "Person" vs. "Persons" vs. "person", etc.) and thus, these parameters are usable and readable by machines. This also prevents orphan articles.

## This approach also applies to any other new entry: first find the category that object would belong to, then create it under that category and fill in the important parameters.

## For advanced users: some relationship parameters are pre-defined, but it is possible to add new parameters to a whole category. This should be done in consultation with those involved with curating the ontological infrastructure so as to be consistent and organized.

OK, now you should be set up with the basics of a user profile and understand the basic mechanics of how the BatteryKB is built. Now, you want to start making real contributions to the content. Here are some how-to guides for specific actions when creating wiki content.

First, before you attempt to add an image, you have to again understand that '''everything''' in this wiki exists on an ontological framework. Just as you can't type in a person's name into a parameter field as text without making them first a User entity, you can't simply upload an image to an article or entity as it is. The ''image'' has to exist as an '''entity''', too. But, as you also learned above, you can create this entity on the fly.

# At the top of the bar, click Insert Images and media.

# Click the blue button to "Create a new element in a separate dialog". This will allow you to upload the image as an ''entity'', save it and then come back to your original image insertion to ''link'' it to the article.

# At the top of the new dialog box Data-Editor, it should say Wiki File.

## Add in filename

==== How to add a table ====

==== How to start a new article ====