Invitees:
Chip Dalby, Hadas Niv, Mark Foster, Christian Pama, Les Cottrell.
- Hadas was needed to understand the requirements and provide guidance for KB articles. She provided the following guidance in advance and so did not need to attend
- There are no formal guidelines. Hadas provided the following suggestions:
If the audience is SLAC windows users, KB is preferred. A limited set of Unix users cannot log into ServiceNow.
- If it is for the Networking team, it can be anywhere they want.
- There are no requirements for KB – licensed users just write them and publish them. Some ask their team to review and edit, others do not.
It can be a URL to Confluence, or a copy.
The team should decide what is best.
If a URL - the user may need to log in again (to Confluence).
If a copy - it will have to be maintained in both places.
- There are no formal guidelines. Hadas provided the following suggestions:
Agenda
- Reason for meeting
- Guidelines for KB articles
- Potential move of <= 4 web pages to KB
- Potential move/updates of:
- Photo
Reason for meeting
The networking home web page at http://networking.slac.stanford.edu/ is currently written using Microsoft's Expression Web application. This is no longer supported by Microsoft so I have agreed with Ben to port the page to Drupal. At the same time we (Chip Dalby and I) have identified some updates are needed to the contents (e.g. remove/replace broken links, I have taken care of the broken links in Expression Web in preparation for the port). There are also links to about 5 pages in Confluence that are possible ServiceNow Knowledge Base (KB) articles. One already is, it is https://confluence.slac.stanford.edu/display/NetMan/How+to+Connect+to+SLAC+VPN and is maintained by Andy. The remaining four are:
- https://confluence.slac.stanford.edu/pages/viewpage.action?spaceKey=TAN&title=Reporting+Problems
- May need a new title, at least some information may already be in KB. It was created in 2012 and some parts are out of date
- It covers not just networking, I would guess the non-networking parts are covered by others.
- It requires signing into Confluence.
- https://confluence.slac.stanford.edu/display/NetMan/SLAC+Visitor+Network
- https://confluence.slac.stanford.edu/display/NetMan/Wireless+networking+at+SLAC
- Last update 2012, needs updating
- https://confluence.slac.stanford.edu/display/NetMan/DHCP
- Quite long, may need some editing
If they are to go to KB, then Hadas would like Networking to review the content to ensure its accuracy. Else we can just leave the links to Confluence space.
While we are at it, there are a couple of other pages linked from networking.slac.stanford.edu that may need review:
- https://confluence.slac.stanford.edu/display/NetMan/Network+Forms
Maybe this should be combined with some other OCIO web page/site with a lot of forms - http://confluence.slac.stanford.edu/display/TAN/Network+and+Telecommunications+Policies
I imagine there is a policies site that this might be linked to from. However, since it has not been blessed by any SLAC-wide policy committee maybe the title should be recommendations.
It might be nice to also update the photo.
Guidelines for KB articles:
See Guidelines for ServiceNow KB articles or above.