Let s take a wiki for a spin

Transcription

1 Let s take a wiki for a spin TCANZ nd 3 rd September 2010, Wellington Slide 1 Let s take a wiki for a spin by Sarah Maddox 1

2 Introducing me Sarah Maddox Day job: 12 years as technical writer 10 years as software developer Now in a team of 5 writers Fun: Rollerblading and RipStikking Chocolate Slide 2 Let s take a wiki for a spin by Sarah Maddox 2

3 Introducing Donna Dark Technical communicator extraordinaire New at Dangerous Liaisons Wants to make a bold start I m Donna and I m everybody s hero Slide 3 Let s take a wiki for a spin by Sarah Maddox 3

4 What we will cover A how to, not a showcase of features Introduction to Confluence wiki Creating your technical communication space Customising the dashboard Publishing a blog post Helping other teams with their spaces Staying on top of the news Wrapping it up Questions Slide 4 Let s take a wiki for a spin by Sarah Maddox 4

5 Introducing the wiki A wiki With a wiki, you can edit a web page in your browser Confluence and other brands The dashboard Spaces Pages Slide 5 Let s take a wiki for a spin by Sarah Maddox 5

6 Confluence dashboard Welcome message Recent activity Demo Spaces Slide 6 Let s take a wiki for a spin by Sarah Maddox 6

7 Wiki spaces and pages A hierarchical page structure in a space A page Demo A list of spaces on my Confluence dashboard Slide 7 Let s take a wiki for a spin by Sarah Maddox 7

8 Setting up your team space Talk about intranet team spaces Add our TECHCOMM space Design the home page You know what they say about a new broom Move content into the new space Add the Documentation theme Restructure the content Add the {toc} macro to structure a page Slide 8 Let s take a wiki for a spin by Sarah Maddox 8

9 Adding your space Demo Adding a space to Confluence Slide 9 Let s take a wiki for a spin by Sarah Maddox 9

10 Designing your space s home page Demo The default home page for a space Slide 10 Let s take a wiki for a spin by Sarah Maddox 10

11 Designing your space s home page Demo Our new home page Now let s grab our content from the devs Slide 11 Let s take a wiki for a spin by Sarah Maddox 11

12 Applying the Documentation theme Demo Eek! Pages all over the show! Slide 12 Let s take a wiki for a spin by Sarah Maddox 12

13 Structuring your space Drag and drop the pages into a logical order and grouping Demo Slide 13 Let s take a wiki for a spin by Sarah Maddox 13

14 Structuring a page Demo Add a {toc} to the top of long pages Slide 14 Let s take a wiki for a spin by Sarah Maddox 14

15 Customising the dashboard Bring the intranet to life Get people involved Stimulate debate Allow anyone to update the welcome message Set permissions if necessary Who s been at my dashboard? Slide 15 Let s take a wiki for a spin by Sarah Maddox 15

16 Customising the dashboard Anyone can update our dashboard Real example Photos are fun (This one added when the World Cup was on) Anyone can add the given label to make their page or blog post appear here {contentbylabel} Slide 16 Let s take a wiki for a spin by Sarah Maddox 16

17 Customising the dashboard Real example Chris won FedEx Day Custom macro displays blog posts that have received most comments {most-commented-blogs: inlastdays=3} Slide 17 Let s take a wiki for a spin by Sarah Maddox 17

18 Customising the dashboard Real example A Flash game!crr_041.swf id=media! A link makes it easy to edit the dashboard Slide 18 Let s take a wiki for a spin by Sarah Maddox 18

19 Customising the dashboard Let s create this dashboard Demo A logo Recent blog posts with a given label {include:techcomm:dashboard Welcome Message nopanel=true} Slide 19 Let s take a wiki for a spin by Sarah Maddox 19

20 Publishing a blog post Share news Air your opinion Invite debate Have a voice that even the CEOs will hear Read your colleagues news anywhere Isn t blogging just an ego thing? Me, blow my own trumpet? Never! Slide 20 Let s take a wiki for a spin by Sarah Maddox 20

21 Publishing a blog post Demo Let s create this blog post and see it appear on the dashboard Slide 21 Let s take a wiki for a spin by Sarah Maddox 21

22 Blog posts by new starters Real example A great way to introduce new starters to the company Get people to use the intranet from day 1 Slide 22 Let s take a wiki for a spin by Sarah Maddox 22

23 Helping other teams Get to know the wiki intimately Study the technical aspects of content creation Investigate plugins and advanced features Show people how to organise information Demonstrate the friendly and serious sides of the wiki Slide 23 Let s take a wiki for a spin by Sarah Maddox 23

24 Examples from the Demo space Example HR page Embedded PDF document Layout Demo Company induction Task list Have fun Embedded YouTube videos Example sales team page Photos Excerpt-include Chart Let s take a wiki for a spin by Sarah Maddox Slide 24 24

25 Staying on top of the news Build an RSS feed Use a feed reader Watch a page or space Follow a person Set your notification options I need to stay on top of the news but avoid information overload Slide 25 Let s take a wiki for a spin by Sarah Maddox 25

26 Building an RSS feed Demo Building an RSS feed in Confluence Slide 26 Let s take a wiki for a spin by Sarah Maddox 26

27 Reading an RSS feed Demo A Confluence RSS feed displayed in Sage, showing updates to our TECHCOMM space Slide 27 Let s take a wiki for a spin by Sarah Maddox 27

28 Watching a space Demo Go to Browse > Advanced to watch a space Slide 28 Let s take a wiki for a spin by Sarah Maddox 28

29 Watching a page Demo Select Tools > Watch to watch a page Slide 29 Let s take a wiki for a spin by Sarah Maddox 29

30 Following a person Demo Follow a person via the popup that appears over their name Slide 30 Let s take a wiki for a spin by Sarah Maddox 30

31 Setting your notification options Demo Choose the type of content you want to know about Choose the format of the notifications Slide 31 Let s take a wiki for a spin by Sarah Maddox 31

32 Wrapping it up What wikis are good at How technical communicators can help Taking your own wiki for a spin You gotta believe we are magic Slide 32 Let s take a wiki for a spin by Sarah Maddox 32

33 Taking your own wiki for a spin Download Confluence or try it online: Licensing: Evaluation for 30 days Free for non-profit and open source organisations $10 for a 10-user licence (proceeds go to Room to Read ) Commercial licences based on number of users For this demo I used Confluence 3.3 standalone distribution on Windows Vista. My browser is Firefox. Slide 33 Let s take a wiki for a spin by Sarah Maddox 33

34 Contacting me LinkedIn: Blog: Other blog: Slide 34 Let s take a wiki for a spin by Sarah Maddox 34

35 Questions Slide 35 Let s take a wiki for a spin by Sarah Maddox 35

36 References 1 Confluence wiki Website: Documentation: Plugins: Other A blog post about new employee blog posts: The Demonstration (DS) space in your own Confluence, if installed by your administrator Slide 36 Let s take a wiki for a spin by Sarah Maddox 36

37 References 2 RSS and feed readers Sage add-on for Firefox: Mark Pilgrim's article, "What is RSS? on XML.com: Comparison of RSS feed readers on Wikipedia: The end Slide 37 Let s take a wiki for a spin by Sarah Maddox 37