To get updates on new site content, like us on Facebook or follow us on Twitter.

Difference between revisions of "Wiki Announcement (2019-01-10)"

From JFA Wiki
(Site Considerations)
 
(105 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{jfastart}}{{jfatoc}}
+
{{jfa-toc}}
=== Huh? ===
+
{{jfa-note}}By Greg Fuller 2019-02-10 {{jfa-note-end}}
 +
JusticeforAnimals.org is being converted to a wiki, running on the same platform as Wikipedia. You are looking at the new site in an early stage of conversion.
  
{{jfanote}}By Greg Fuller{{jfanote-end}}
+
We are moving to a wiki platform to help us realize the site's mission of providing an evidence-based, non-hyperbolic, and usefully-organized body of knowledge helpful to vegans, those considering [[veganism]], and especially those engaged in vegan and animal rights advocacy.
  
JusticeforAnimals.org is being converted to a Wiki, running on the same platform as Wikipedia. You are looking at the new site in an early stage of conversion. After the conversion is completed, the site will be moved from wiki.justiceforanimals.org to justiceforanimals.org, replacing the current site. We will provide URL redirection for most of the posts on the current site, so that bookmarks and other links will not break.
+
Exactly how this will help is explained below.
  
{{jfanote}}
+
=== Background ===
Feel free to look around.
 
{{jfanote-end}}
 
  
=== Background ===
+
Last year, a friend put a bug in my ear about using wiki software for justiceforanimals.org. I let the thought simmer, but it kept popping up in my head. I looked at the features of [https://www.MediaWiki.org MediaWiki]—the software that Wikipedia uses. I did a few edits anonymously to the [https://en.wikipedia.org/wiki/Veganism Veganism] article on Wikipedia to familiarize myself with how things work on a wiki site.
 +
 
 +
I was surprised by how capable and well suited the software seemed to be for a site like justiceforanimals.org, even without considering the possibilities for a wider collaborative effort.
  
Last year a friend put the bug in my ear about using Wiki software for justiceforanimals.org. I let the thought simmer but it kept popping up in my head. I looked at the features of MediaWiki—the software that Wikipedia uses—and did a few edits on Wikipedia to familiarize myself with how things work on a Wiki site. I didn't much care for the aesthetics, but I was surprised about how capable and well suited the software seemed to be for justiceforanimals.org, even without considering the possibilities for a wider collaborative effort.
+
I keep trying out stuff until I reached the point of no return. At some point in that process, it became clear just how big an improvement a wiki implementation would be.
  
So I set up an instance and started experimenting, still somewhat skeptical. But the more I learned the more convinced I became. I'm still in the process of rapid discovery, learning about footnotes, table of contents, tables, infoboxes, edit approvals, versioning, user permissions, etc. This immersive experience of beginning the conversion from the old site is allowing me to set up the overall structure for the site and the structure for various types of individual posts.
+
=== Benefits of Moving to a Wiki Platform ===
  
=== Take a Look ===
+
Here are just a few of the benefits of moving [[Main Page|Justice for Animals]] to a wiki site:
  
You can learn about the structure of site by reading the [[Main Page]], which is Wiki talk for home page. The greatest opportunity for outside contributions will be in two new Sections—[[Fact Sheets]] and [[Summaries]]. Visit the other Section Pages in the Sidebar Menu to see the kinds of entries in each section. See an example of a post that's been converted [[Objection:_I_am_only_one_person_-_I_cannot_make_a_difference|here]].
+
'''Collaboration.''' The ability to engage other contributors in a more collaborative effort will result in more content more quickly. The greatest opportunity for outside contributions initially will be in two new sections—[[Fact Sheets Section|Fact Sheets]] and [[Summaries Section|Summaries]].
  
=== Advantages ===
+
'''Productivity.''' Since I've started working on this platform, I am impressed by how much faster one can jump in and start writing, editing, and cross-linking. When you see something wrong, you can hit the edit button and fix it immediately. You no longer have to go through a cumbersome administrative back end to get things done. As a result, things do get done.
  
Here are just a few of the benefits of using a wiki site:
+
'''Cross-Linking.''' The wiki platform offers stronger and easier-to-use capabilities for cross-linking the information between pages and site sections. It just wasn't getting done on the WordPress site. With more content and the two new sections mentioned earlier, this becomes even more important.
  
'''Collaboration.''' The ability to engage other contributors in a more collaborative effort will result in more content more quickly.
+
'''History and Version Control.''' The platform tracks all edits to a page, allowing any version to be compared with any other version and easily be reverted. WordPress does, too, but it's cumbersome and not suited to a collaborative environment.
  
'''Cross-Linking.''' The wiki platform offers strong capabilities for cross-linking the information between posts and the sections, something that is much easier on with MediaWiki. It just wasn't getting done on the WordPress site. With two new sections, and possibly more in the future, this becomes even more important.
+
'''Richer Presentation.''' The wiki platform makes it easy to produce a table of contents, citations, nicely formatted tables, information boxes, and more. Some of this was possible before but was not being used to its full advantage because it was difficult. Here it's easy.
  
'''Richer Presentation.''' The wiki platform makes it easy to produce a table of contents, citations, nicely formatted tables, information boxes, etc. Some of this was possible before but was not being used to its full advantage because it was difficult. Here it's easy.
+
'''Internationalization.''' MediaWiki supports content internationalization such that translators can enter and edit their translations for a page directly on the system. This is the same system successfully used by Wikipedia and other large wikis. This won't be set up initially because of time constraints, but it's good to know it's there.  
  
'''Productivity.'' Since I've started working on this platform, I am impressed by how much faster I can jump in and start writing, editing, and cross-linking.  
+
'''Discussion Pages.''' Every page has a discussion page where we can record information pertaining to the page without putting it on the page itself. This could include editorial comments, notes on future improvements to the page, or anything else.
  
'''Common Skills.''' With the WordPress site, in order to contribute, one had to be trained in a system that was specific to that site. Here, there's learning to be done, but it's the same platform as Wikipedia, and help is readily available by searching the MediaWiki site. Wikipedia has proven this can work.  
+
'''Common Skills.''' With the WordPress site, in order to contribute, one had to be trained in a system that was more specific to that site. Here, there's learning to be done, but it's the same platform as Wikipedia. The features are well documented and help is readily available. Wikipedia has proven this can work.  
  
'''Continuity''' I would like for others to not only be involved in content creation and editing, but also in managing the site. I won't be around forever, and something could happen to me at any time.
+
'''Continuity.''' I would like for others to not only be involved in content creation and editing but also in managing the site. I won't be around forever, and something could happen to me at any time. The wiki platform does what we need it to do without a lot of third-party and homegrown customizations, making it easier for someone to jump in and help with system maintenance—or even take over.
  
 
=== Site Considerations ===
 
=== Site Considerations ===
  
It's a whole new ball game for how the site is organized and how contributions are managed.
+
It's a whole new ball game for how the information on the site is presented and how contributions are managed.
  
'''Content Contribution.''' As more people start participating in creating and editing content, many possibilities exist for how page creation and editing can be controlled. Decisions surrounding this are under consideration. Among the possibilities:
+
'''Content Contribution.''' As more people start participating in creating and editing content, many possibilities will exist for how page creation and editing can be managed. Decisions surrounding this are under consideration. Among the possibilities are the following:
 
* Allow anonymous users to edit pages and possibly create pages.
 
* Allow anonymous users to edit pages and possibly create pages.
* Allow all registered users with verified emails to create and edit pages.
+
* Only allow registered users with verified emails to create and edit pages.
* Contribution by invitation. This would result in having a team of contributors, and the team could be large.
+
* Contribution by invitation. This would result in having a team of contributors that have been vetted to some extent.
  
This kind and degree of participation would be very difficult with the current platform.
+
This kind and degree of participation would be very difficult with the current platform.  
  
'''Foundational Articles.''' As more content gets created, the more foundational information could get lost in the sea. This is certainly not a problem now, as everything being work on is considered foundational. As the site grows, foundational articles from each section can flagged as foundational and be given higher visibility.  
+
'''Foundational Pages.''' As more content gets created, the information that is more [[Help:Foundational Pages|foundational]] could get lost in the sea. This is certainly not a problem now, as most everything being worked on is considered foundational. As the site grows, foundational pages from each section can be flagged as such and be given higher visibility.
  
'''Copy Editing.''' Currently, all articles are copyedited by a professional copy editor, Isaac Nickerson. This has resulted in high-quality content. As more contributors get involved, it will be difficult to maintain this standard for all articles.
+
{{jfa-note}}Think of foundational information as the basic things you should know in order to be the most effective advocate for [[veganism]] and animal rights.{{jfa-note-end}}
  
The platform supports flagging of content based on quality. We can use this feature, combined with an approval process, to make it clear to the user where an article stands in this regard. The goal is to have all foundational articles copy edited.
+
'''Copyediting.''' Currently, all articles are copyedited by a professional copy editor, Isaac Nickerson. This has resulted in high-quality content. As more contributors get involved, it will be difficult to maintain this standard for all pages.
  
'''Outlining.''' I thought the outline feature would be useful, but it's hasn't generated any interest. That may be because people need to be educated about how outlines can be used. Outlines take considerable work to maintain, and I'm not sure people will use them.  
+
The platform supports flagging of content based on quality. We can use this feature, combined with an approval process, to make it clear to the user where a page stands in this regard. The goal is to have all foundational articles copyedited.
  
Here's what I'm thinking: Put what is now in the "Details" and "Extra" part of an outline into a collapsible box in the article, and have its initial state be collapsed. This would work well for much of what is there now, but it would not work for deeper outlines. Much of the content in deeper outlines can be moved to Fact Sheets.
+
'''Outlining.''' I thought the outline feature would be useful, but it hasn't generated any interest. That may be because people need to be educated about how outlines can be used. Outlines take considerable work to maintain, and I'm not sure people will use them.  
  
Please let me know how you feel about this.  
+
Here's what I'm thinking: Put what is now in the Details and Extra parts of an outline into a collapsible box in the article and have the box's initial state be collapsed. This would work well for much of what is there now, but it would not work for deeper outlines. Much of the content in deeper outlines, however, can be moved to [[Fact Sheets Section|Fact Sheets]].
  
Only two of the plugin programs that I wrote will have to be rewritten: One for the ''copy to clipboard'' functionality, and one to expand and collapse outline nodes.
+
{{jfa-note}}Fact Sheets provide support for a variety of assertions that are commonly made in advocating for [[veganism]] and animal rights. Each fact sheet consists of one assertion, followed by summarized citations of supporting evidence for that assertion.{{jfa-note-end}}
  
I have not set up the Visual Editor yet, but I've used it on Wikipedia and it was one of my considerations in moving forward with a wiki solution. Although wiki markup notation is quickly learned, the Visual Editor will make it even more appealing. Even without the Visual Editor, ease of editing is orders of magnitude better than the current platform. The ability to edit small portions of a post quickly is a godsend.
+
'''Clipboard.''' I think that having a plain-text version of an article that can easily be copied and pasted without formatting problems is useful. We should keep this feature but only require it on foundational articles. As richer content that includes such things as tables and information boxes is put into the main articles, that text will become even less amenable to copy and paste. The feature will be implemented differently, though, making it easier to copy and paste small portions of an article. It will also be easier for an author to derive the plain-text version from the article.
 +
 
 +
'''Aesthetics.''' In general, wiki sites look drab, but they don't have to. I have changed the header and sidebar of the standard skin already, (compare to [https://www.MediaWiki.org MediaWiki]) and I'm working on improving the fonts, colors, and spacing as well as customizing the presentation on mobile devices. But this should not take priority over content, as it has in the past. Still, the site should look inviting.
 +
 
 +
'''Visual Editor.''' A visual editor is available that lets you edit without dealing with wiki notation. Although wiki notation is quickly learned, the Visual Editor would make editing even easier. The feature requires a separate server, so it's not a matter of just flipping a switch. I'm working on it.
 +
 
 +
'''URL Redirection.''' After the conversion is complete, the site will be moved from wiki.justiceforanimals.org to justiceforanimals.org, replacing the current site. Because a wiki uses a different URL structure, URL redirection will be provided for most of the posts on the current site so that existing bookmarks and other links to pages will not break.
 +
 
 +
=== Take a Look ===
  
A lot of work and thought went into this decision. All the factors would take too long to explain, but I'm confident this is a good move for the site, and for the site's [[Mission and Guiding Principles|mission]].
+
You can learn about the structure of the site by reading the [[Main Page]], which is wiki talk for home page. Visit the section pages shown in the sidebar menu to see the kinds of entries in each section, particularly the two new sections, [[Fact Sheeets Section|Fact Sheets]] and [[Summaries Section|Summaries]]. See an example of a post in the [[Objections Section]] that's been converted by going [[Objection:_I_am_only_one_person_-_I_cannot_make_a_difference|here]].
  
 +
=== Now What? ===
  
 +
It's obvious there's lots to be done, some of which is on the [[Help:Implementation Notes|Implementation Notes]] page. I'm working hard to make the conversion happen as quickly as possible.
  
==== Moving Forward ====
+
{{jfa-note}}If you got to this page from an external link, you can get back to it from the Wiki Announcement link in the sidebar.{{jfa-note-end}}
  
There's lots to be done, some of which is on the [[To Do]] page. This includes improving the aesthetics, which I've already worked on quite a bit. I will be changing the fonts and other parts of the design before GoLive.
+
{{jfa-meta
 +
| meta-title = Wiki Announcement
 +
| meta-keywords = wiki, veganism, animal rights
 +
| meta-description = This blog post announces the decision to move the posts to a wiki, then discusses the advantages and challenges of doing so.
 +
}}
  
I'm excited about the current and future possibilities of being on a Wiki platform.
+
[[ Category: Blog | 2019-01-10 ]]
 +
[[ Category: Website | 2019-01-10 ]]

Latest revision as of 12:14, 26 September 2019

By Greg Fuller 2019-02-10

JusticeforAnimals.org is being converted to a wiki, running on the same platform as Wikipedia. You are looking at the new site in an early stage of conversion.

We are moving to a wiki platform to help us realize the site's mission of providing an evidence-based, non-hyperbolic, and usefully-organized body of knowledge helpful to vegans, those considering veganism, and especially those engaged in vegan and animal rights advocacy.

Exactly how this will help is explained below.

Background

Last year, a friend put a bug in my ear about using wiki software for justiceforanimals.org. I let the thought simmer, but it kept popping up in my head. I looked at the features of MediaWiki—the software that Wikipedia uses. I did a few edits anonymously to the Veganism article on Wikipedia to familiarize myself with how things work on a wiki site.

I was surprised by how capable and well suited the software seemed to be for a site like justiceforanimals.org, even without considering the possibilities for a wider collaborative effort.

I keep trying out stuff until I reached the point of no return. At some point in that process, it became clear just how big an improvement a wiki implementation would be.

Benefits of Moving to a Wiki Platform

Here are just a few of the benefits of moving Justice for Animals to a wiki site:

Collaboration. The ability to engage other contributors in a more collaborative effort will result in more content more quickly. The greatest opportunity for outside contributions initially will be in two new sections—Fact Sheets and Summaries.

Productivity. Since I've started working on this platform, I am impressed by how much faster one can jump in and start writing, editing, and cross-linking. When you see something wrong, you can hit the edit button and fix it immediately. You no longer have to go through a cumbersome administrative back end to get things done. As a result, things do get done.

Cross-Linking. The wiki platform offers stronger and easier-to-use capabilities for cross-linking the information between pages and site sections. It just wasn't getting done on the WordPress site. With more content and the two new sections mentioned earlier, this becomes even more important.

History and Version Control. The platform tracks all edits to a page, allowing any version to be compared with any other version and easily be reverted. WordPress does, too, but it's cumbersome and not suited to a collaborative environment.

Richer Presentation. The wiki platform makes it easy to produce a table of contents, citations, nicely formatted tables, information boxes, and more. Some of this was possible before but was not being used to its full advantage because it was difficult. Here it's easy.

Internationalization. MediaWiki supports content internationalization such that translators can enter and edit their translations for a page directly on the system. This is the same system successfully used by Wikipedia and other large wikis. This won't be set up initially because of time constraints, but it's good to know it's there.

Discussion Pages. Every page has a discussion page where we can record information pertaining to the page without putting it on the page itself. This could include editorial comments, notes on future improvements to the page, or anything else.

Common Skills. With the WordPress site, in order to contribute, one had to be trained in a system that was more specific to that site. Here, there's learning to be done, but it's the same platform as Wikipedia. The features are well documented and help is readily available. Wikipedia has proven this can work.

Continuity. I would like for others to not only be involved in content creation and editing but also in managing the site. I won't be around forever, and something could happen to me at any time. The wiki platform does what we need it to do without a lot of third-party and homegrown customizations, making it easier for someone to jump in and help with system maintenance—or even take over.

Site Considerations

It's a whole new ball game for how the information on the site is presented and how contributions are managed.

Content Contribution. As more people start participating in creating and editing content, many possibilities will exist for how page creation and editing can be managed. Decisions surrounding this are under consideration. Among the possibilities are the following:

  • Allow anonymous users to edit pages and possibly create pages.
  • Only allow registered users with verified emails to create and edit pages.
  • Contribution by invitation. This would result in having a team of contributors that have been vetted to some extent.

This kind and degree of participation would be very difficult with the current platform.

Foundational Pages. As more content gets created, the information that is more foundational could get lost in the sea. This is certainly not a problem now, as most everything being worked on is considered foundational. As the site grows, foundational pages from each section can be flagged as such and be given higher visibility.

Think of foundational information as the basic things you should know in order to be the most effective advocate for veganism and animal rights.

Copyediting. Currently, all articles are copyedited by a professional copy editor, Isaac Nickerson. This has resulted in high-quality content. As more contributors get involved, it will be difficult to maintain this standard for all pages.

The platform supports flagging of content based on quality. We can use this feature, combined with an approval process, to make it clear to the user where a page stands in this regard. The goal is to have all foundational articles copyedited.

Outlining. I thought the outline feature would be useful, but it hasn't generated any interest. That may be because people need to be educated about how outlines can be used. Outlines take considerable work to maintain, and I'm not sure people will use them.

Here's what I'm thinking: Put what is now in the Details and Extra parts of an outline into a collapsible box in the article and have the box's initial state be collapsed. This would work well for much of what is there now, but it would not work for deeper outlines. Much of the content in deeper outlines, however, can be moved to Fact Sheets.

Fact Sheets provide support for a variety of assertions that are commonly made in advocating for veganism and animal rights. Each fact sheet consists of one assertion, followed by summarized citations of supporting evidence for that assertion.

Clipboard. I think that having a plain-text version of an article that can easily be copied and pasted without formatting problems is useful. We should keep this feature but only require it on foundational articles. As richer content that includes such things as tables and information boxes is put into the main articles, that text will become even less amenable to copy and paste. The feature will be implemented differently, though, making it easier to copy and paste small portions of an article. It will also be easier for an author to derive the plain-text version from the article.

Aesthetics. In general, wiki sites look drab, but they don't have to. I have changed the header and sidebar of the standard skin already, (compare to MediaWiki) and I'm working on improving the fonts, colors, and spacing as well as customizing the presentation on mobile devices. But this should not take priority over content, as it has in the past. Still, the site should look inviting.

Visual Editor. A visual editor is available that lets you edit without dealing with wiki notation. Although wiki notation is quickly learned, the Visual Editor would make editing even easier. The feature requires a separate server, so it's not a matter of just flipping a switch. I'm working on it.

URL Redirection. After the conversion is complete, the site will be moved from wiki.justiceforanimals.org to justiceforanimals.org, replacing the current site. Because a wiki uses a different URL structure, URL redirection will be provided for most of the posts on the current site so that existing bookmarks and other links to pages will not break.

Take a Look

You can learn about the structure of the site by reading the Main Page, which is wiki talk for home page. Visit the section pages shown in the sidebar menu to see the kinds of entries in each section, particularly the two new sections, Fact Sheets and Summaries. See an example of a post in the Objections Section that's been converted by going here.

Now What?

It's obvious there's lots to be done, some of which is on the Implementation Notes page. I'm working hard to make the conversion happen as quickly as possible.

If you got to this page from an external link, you can get back to it from the Wiki Announcement link in the sidebar.