EditingTeamPages: Difference between revisions

From Portland NET Wiki
← Older editNewer edit →
VisualWikitext
Revise Policies section to match new Volunteer Subject Matter Expert page.
consolidate and slightly simplify guidance for editing team pages
Line 22: Line 22:


Wikis are unfortunately not as pretty as WordPress. The emphasis is more on content than style.
Wikis are unfortunately not as pretty as WordPress. The emphasis is more on content than style.
=== Editors ===
There are two editors available:
* The visual (WYSIWYG) editor, entered via the <code>Edit</code> and <code>Create</code> buttons.
* The wikitext (markup) editor, entered via the <code>Edit source</code> and <code>Create source</code> buttons.
The visual editor is most useful for new users, but even users comfortable with markup will find it useful for e.g. providing template parameters. You can choose either, and even switch between them in the same editing session.


=== Your First Edit ===
=== Your First Edit ===
Line 34: Line 42:
# Click the <code>Save page...</code> button.
# Click the <code>Save page...</code> button.
# Provide a summary of your changes or rationale. For example, "Update school list".
# Provide a summary of your changes or rationale. For example, "Update school list".
=== To make a good team page ===
✅ Add/update neighborhood populations<br/>
✅ Add/update fire stations<br/>
✅ Add/update schools<br>
✅ Add/update BEECN sites<br>
✅ Ops Plan: All '''Ops Plan links are hosted on portland.gov'''. Check link, and use the "plan_name" parameter to the <nowiki>{{Team}}</nowiki> template if it doesn't match.<br>
✅ Send updated Ops Plan to PBEM ({{EmailLink|net@portlandoregon.gov|name=net@portlandoregon.gov}}).<br />


== Editing ==
== Editing ==


=== Editors ===
=== What Goes On A Team Page? ===
There are two editors available:
Your team page could be the single link your team hands out at block parties or when new neighbors move in.


* The visual (WYSIWYG) editor, entered via the <code>Edit</code> and <code>Create</code> buttons.
Please consider it a "landing page" that describes aspects of emergency preparedness that are ''unique to your neighborhood''. For example,
* The wikitext (markup) editor, entered via the <code>Edit source</code> and <code>Create source</code> buttons.


The visual editor is most useful for new users, but even users comfortable with markup will find its guidance useful for e.g. providing template parameters. You can choose either, and even switch between them in the same editing session.
* For potential volunteers:
** provide ways to engage with the local team (e.g. team point of contact, public discussion forums)
** describe unique considerations (e.g. "we work closely with this school," "we meet at this location", "90% of Oregon's fuel supply passes through our neighborhood")
** team accomplishments (e.g. "we've deployed at warming shelters", "we provided first aid at this parade")
* For existing team members:
** recognize team positions (e.g. Team Leader, Amateur Radio Operators)
** contain important links (e.g. to a shared team folder, or to the Operations Plan)


=== Every Page Should Contain ===
Some content belongs elsewhere:
There are a number of templates useful for NET Team pages.


Every team page should use these templates. They provide a consistent look and feel, and group team pages into categories:
* News: this content often goes stale, and is better shared in team discussion forums.
* Orientation to the NET program: this is best centralized at PBEM, rather than re-written by individual teams.
* Tips for personal preparedness: this is best centralized at PublicAlerts.org, rather than re-written by individual teams.


* [[Template:TeamPageBanner]]
=== Team Page Editing Checklist ===
* [[Template:Team]]
* [[Template:Neighborhood]]


=== Other Useful Templates ===
# ✅ Check the link to your Operations Plan, and use the "plan_name" parameter to the <nowiki>{{Team}}</nowiki> template if it doesn't match. (All Ops Plan links are hosted on portland.gov. If yours is out of date, email an updated file to {{EmailLink|net@portlandoregon.gov|name=net@portlandoregon.gov}}.)
Other templates do things like make links pretty. Please use them for more appealing team pages:
# ✅ Add/update neighborhood populations in the <nowiki>{{Neighborhood}}</nowiki> templates. (See [https://www.portland.gov/civic/myneighborhood/neighborhood-profile-maps Neighborhood Demographic Profiles] page.)
* [[Template:EmailLink]]
# ✅ Add/update BEECN and fire station sites in the <nowiki>{{Neighborhood}}</nowiki> templates. (See [https://pdx.maps.arcgis.com/apps/webappviewer/index.html?id=d3eaa87bf97148a78a5f358207259d72 BEECNs and Fire Stations] map.)
* [[Template:GoogleDocLink]]
# ✅ Add/update schools in the <nowiki>{{Neighborhood}}</nowiki> templates.
* [[Template:FacebookLink]]
# ✅ Use [[#Link Templates]] for pretty little icons.
* [[Template:GroupsLink]]
# ✅ Read the [[#Policies]] section below.
* [[Template:InstagramLink]]
* [[Template:SignalLink]]


=== Can I Upload Photos Or Team Documents? ===
For most files, please upload them separately and link to them from your team pages.


Here is how they are useful:
Where to host different types of files:
{| class="wikitable"
{| class="wikitable"
!
!file type
!Unformatted text
!where to host it
!Displays as
|-
|small inline images (e.g. team members in action)
|team page
|-
|small inline neighborhood map
|team page
|-
|Photo albums (e.g. team exercises)
|send an email to {{EmailLink|addr=net@portlandoregon.gov|name=net@portlandoregon.gov}} for an upload link
|-
|Operations plans
|[https://www.portland.gov/pbem/neighborhood-emergency-teams/crtopsplans NET Team Operations Plans] (email to {{EmailLink|addr=net@portlandoregon.gov|name=net@portlandoregon.gov}})
|-
|Meeting minutes
|3rd-party file hosting (e.g. Google Drive)
|-
|-
|
|Internal team documents (e.g. spreadsheets, planning documents)
|<nowiki>net@portlandoregon.gov</nowiki>
|3rd-party file hosting (e.g. Google Drive)
|net@portlandoregon.gov
|-
|-
|
|Outreach materials
|<nowiki>[mailto:net@portlandoregon.gov net@portlandoregon.gov]</nowiki>
|3rd-party file hosting (e.g. Google Drive)
|[mailto:net@portlandoregon.gov net@portlandoregon.gov]
|}
 
=== Link Templates ===
For example:
{| class="wikitable"
!Template
!Displays as
|-
|-
|template:
|<nowiki>{{EmailLink|net@portlandoregon.gov}}</nowiki>
|<nowiki>{{EmailLink|net@portlandoregon.gov}}</nowiki>
|{{EmailLink|addr=net@portlandoregon.gov}}
|{{EmailLink|net@portlandoregon.gov}}
|-
|
|<nowiki>[https://www.facebook.com/groups/portlandprepares PortlandPrepares]</nowiki>
|[https://www.facebook.com/groups/portlandprepares PortlandPrepares]
|-
|-
|template:
|<nowiki>{{FacebookLink|groups/portlandprepares|name=PortlandPrepares}}</nowiki>
|<nowiki>{{FacebookLink|groups/portlandprepares|name=PortlandPrepares}}</nowiki>
|{{FacebookLink|groups/portlandprepares|name=PortlandPrepares}}
|{{FacebookLink|groups/portlandprepares|name=PortlandPrepares}}
|}
|}


=== What is missing? ===
Click on each template in the list below to understand how to use it:
* [[Template:EmailLink]]
* [[Template:GoogleDocLink]]
* [[Template:FacebookLink]]
* [[Template:GroupsLink]]
* [[Template:InstagramLink]]
* [[Template:SignalLink]]
 
=== What Is Missing? ===
The current wishlist:
The current wishlist:


* Add an extension to embed team calendars.
* Add an extension to embed team calendars.
* Add an extension for GIS integration, which would allow us to easily embed live maps.
* Add an extension for GIS integration, which would allow us to easily embed live maps.
=== Useful resources ===
* [https://www.portland.gov/civic/myneighborhood/neighborhood-profile-maps Neighborhood Demographic Profiles]
* [https://pdx.maps.arcgis.com/apps/webappviewer/index.html?id=d3eaa87bf97148a78a5f358207259d72 BEECNs and Fire Stations] map
* [https://pdx.maps.arcgis.com/apps/mapviewer/index.html?webmap=957ef6fdd06e45bf9ff86e591f61da96 Portland Neighborhood Boundaries] map
* [https://pdx.maps.arcgis.com/apps/mapviewer/index.html?webmap=02a93776ebc742be80d3d5dcd4e03e89 Portland City Council Districts] map


=== How to get help ===
=== How to get help ===
Line 137: Line 154:


Your contributions to this wiki are released under the Creative Commons Attribution-Share Alike license.
Your contributions to this wiki are released under the Creative Commons Attribution-Share Alike license.
=== Team Pages ===
==== What goes on a team page? ====
Your team page could be the single link your team hands out at block parties or when new neighbors move in.
Please consider it a "landing page" that describes aspects of emergency preparedness that are ''unique to your neighborhood''. For example,
* For potential volunteers:
** provide ways to engage with the local team (e.g. team point of contact, public discussion forums)
** describe unique considerations (e.g. "we work closely with this school," "we meet at this location", "90% of Oregon's fuel supply passes through our neighborhood")
** team accomplishments (e.g. "we've deployed at warming shelters", "we provided first aid at this parade")
* For existing team members:
** recognize team positions (e.g. Team Leader, Amateur Radio Operators)
** contain important links (e.g. to a shared team folder, or to the Operations Plan)
Some content belongs elsewhere:
* News: this content often goes stale, and is better shared in team discussion forums.
* Orientation to the NET program: this is best centralized at PBEM, rather than re-written by individual teams.
* Tips for personal preparedness: this is best centralized at PublicAlerts.org, rather than re-written by individual teams.
==== Can I upload photos or team documents? ====
For most files, please upload them separately and link to them from your team pages.
Where to host different types of files:
{| class="wikitable"
!file type
!where to host it
|-
|small inline images (e.g. team members in action)
|team page
|-
|small neighborhood map
|team page
|-
|Photo albums (e.g. team exercises)
|send an email to {{EmailLink|addr=net@portlandoregon.gov|name=net@portlandoregon.gov}} for an upload link
|-
|Operations plans
|[https://www.portland.gov/pbem/neighborhood-emergency-teams/crtopsplans NET Team Operations Plans] (email to {{EmailLink|addr=net@portlandoregon.gov|name=net@portlandoregon.gov}})
|-
|Meeting minutes
|3rd-party file hosting (e.g. Google Drive)
|-
|Internal team documents (e.g. spreadsheets, planning documents)
|3rd-party file hosting (e.g. Google Drive)
|-
|Outreach materials
|3rd-party file hosting (e.g. Google Drive)
|}


==== Can other NET members edit my team's page? ====
==== Can other NET members edit my team's page? ====
Retrieved from "https://volunteerpdx.net/index.php/EditingTeamPages"