Comments for North Bay Communicators Network http://www.northbaycommunicators.org Resources for resilience Mon, 10 Aug 2015 17:59:52 +0000 hourly 1 https://wordpress.org/?v=4.7.9 Comment on August Meeting: API/Software Authoring Environments by Monique Semp http://www.northbaycommunicators.org/2015/07/august-meeting-apisoftware-authoring-environments/#comment-32287 Mon, 10 Aug 2015 17:59:52 +0000 http://www.northbaycommunicators.org/?p=1105#comment-32287 I think auto-generators such as Doxygen and Javadoc are essential for the reference material. But what I’m always looking for is a useful way to tie/hyperlink a reference topic to related User’s/Developer’s Guide info that is typically authored outside of Doxygen/Javadoc. Although one can use Markdown and extra (typically .page in Doxygen) files to hold non-reference material that gets included in the Doxygen/Javadoc output, these autogenerators aren’t very good authoring environments for that sort of info and for the more detailed/complex formatting that’s often desired.

I’m just starting to look into Breathe and Sphinx, so if anyone is using those tools I’d love to hear about it!

Thanks,
-Monique Semp

]]>
Comment on August Meeting: API/Software Authoring Environments by Rebecca Firestone http://www.northbaycommunicators.org/2015/07/august-meeting-apisoftware-authoring-environments/#comment-32186 Wed, 05 Aug 2015 16:41:46 +0000 http://www.northbaycommunicators.org/?p=1105#comment-32186 Who has seen a successful implementation of a lightweight or ultra lightweight authoring environment for knowledge sharing, training, and possibly external facing documentation, with photo illustrated work instructions for detailed hardware fabrication/testing/assembly? For example, team of 13 core engineers, up to 60 contributors.

What did this environment look like, and what did it take to keep it good? Did you need FT writers? How many/skillsets/task division?

In particular, what would a successful implementation of Google Docs look like?

Has anyone had to do REMEDIAL work in an environment where this wasn’t set up but now needs to be?

Do these environments ever actually run themselves, as some sponsors seem to believe they should?

(I know a bit off topic from API… but principles may still apply)

]]>
Comment on February Meeting: Making Yourself Marketable in 2015 by Scott Prentice http://www.northbaycommunicators.org/2015/01/february-meeting-andrew-davis/#comment-26702 Mon, 09 Mar 2015 17:56:04 +0000 http://www.northbaycommunicators.org/?p=1059#comment-26702 Sorry for the delay Chris! Just uploaded PDFs!

]]>
Comment on February Meeting: Making Yourself Marketable in 2015 by Chris Muntzer http://www.northbaycommunicators.org/2015/01/february-meeting-andrew-davis/#comment-25697 Tue, 17 Feb 2015 14:44:34 +0000 http://www.northbaycommunicators.org/?p=1059#comment-25697 Hi Scott,

Did Andrew send you the presentation slides for the last meeting?

A couple of people could not make the presentation, and would benefit from getting his presentation slides.

Cheers,
Chris

]]>
Comment on Education/Training by Andrew Davis http://www.northbaycommunicators.org/resources/education-training/#comment-25123 Thu, 05 Feb 2015 18:12:34 +0000 http://www.northbaycommunicators.org/?page_id=152#comment-25123 I often hear that the “Advice” section of Synergistech Communications’ site, http://www.synergistech.com/advice.shtml, is very helpful to would-be technical communicators preparing for their job search. There’s exhaustive, almost-too-candid advice on gaining marketable skills, resume and portfolio preparation and presentation, interviewing, negotiating, and more. Feedback welcome!

]]>
Comment on Chris Muntzer by Andrew Davis http://www.northbaycommunicators.org/member-directory/chris-muntzer/#comment-25122 Thu, 05 Feb 2015 18:06:44 +0000 http://www.northbaycommunicators.org/?page_id=232#comment-25122 Chris, I noticed that Synergistech Communications isn’t listed in NB Comm’s “Jobs” resources page. Can you help me rectify that important omission? Here’s my blurb:

Synergistech Communications [www.synergistech.com] recruits staff and contract technical communicators throughout the SF Bay Area, and lists its clients’ opportunities at http://www.synergistech.com/jobs.

Thanks very much!

]]>
Comment on NOTES: Intelligent Content Conference Feb. 27th and 28th, 2014 by mikeziegenhagen http://www.northbaycommunicators.org/2014/03/intelligent-content-conference-feb-27th-and-28th-2014/#comment-3252 Wed, 20 Aug 2014 18:32:57 +0000 http://www.northbaycommunicators.org/?p=843#comment-3252 Not at all, please feel free to share this info with your group. Thanks for asking!

]]>
Comment on NOTES: Intelligent Content Conference Feb. 27th and 28th, 2014 by Virtual Business Addresses San Francisco http://www.northbaycommunicators.org/2014/03/intelligent-content-conference-feb-27th-and-28th-2014/#comment-1891 Thu, 14 Aug 2014 21:13:09 +0000 http://www.northbaycommunicators.org/?p=843#comment-1891 Hello there! Would you mind if I share your blog with my myspace
group? There’s a lot of folks that I think would really
appreciate your content. Please let me know. Cheers

Here is my website – Virtual Business Addresses San Francisco

]]>
Comment on August Roundtable/Social: Hopmonk Tavern in Novato by Mike Ziegenhagen http://www.northbaycommunicators.org/2014/08/august-roundtablesocial-hopmonk-tavern-in-novato/#comment-1623 Wed, 13 Aug 2014 04:05:46 +0000 http://www.northbaycommunicators.org/?p=1017#comment-1623 Oh, I forgot Val Swisher’s project, Translators without Borders. “Imagine a world where a person has access to all medical knowledge in their own language.”
http://en.wikipedia.org/wiki/Wikipedia:WikiProject_Medicine
Val uses volunteer technical writers to rewrite medical topics in simplified English to prepare them for translation. She is with Content Rules.

]]>
Comment on August Roundtable/Social: Hopmonk Tavern in Novato by Mike Ziegenhagen http://www.northbaycommunicators.org/2014/08/august-roundtablesocial-hopmonk-tavern-in-novato/#comment-1622 Wed, 13 Aug 2014 03:50:52 +0000 http://www.northbaycommunicators.org/?p=1017#comment-1622 Good meeting, great fun! Here’s a couple links for things that you may find interesting:
Annotate the world wide web: https://hypothes.is/

“Weird Al” Yankovic – Word Crimes – YouTube
http://www.youtube.com/watch?v=8Gv0H-vPoDc
Coincidence is not irony! Wow, I was just saying that to my TV the other day! That’s ironic, I mean coincidental.

]]>
http://www.northbaycommunicators.org/comments/feed/
www.northbaycommunicators.org
crawl=CC-MAIN-2018-09
14669
application/http; msgtype=response
sha1:BKFZJ2FON7LU7QVPGCBX5RQ5QC57DQWM
<urn:uuid:45f84632-641f-4967-95a5-6651d40177c6>
2018-02-20T23:21:29Z
64.50.185.52
application/rss+xml
sha1:NVFJYMBOWOWHCIEDJ27UURLXX5ZNFS6V
<urn:uuid:4a473f2e-aa87-4334-90a3-076d106f5df3>
http://www.northbaycommunicators.org/comments/feed/
length
response
<urn:uuid:08b43d61-78ac-43e4-a8fa-0e1b8572b685>
robots: classic
hostname: ip-10-141-7-146.ec2.internal
software: Nutch 1.6 (CC)
isPartOf: CC-MAIN-2018-09
operator: Common Crawl Admin
description: Wide crawl of the web for February 2018
publisher: Common Crawl
format: WARC File Format 1.0
conformsTo: http://bibnum.bnf.fr/WARC/WARC_ISO_28500_version1_latestdraft.pdf