David Ornstein's WebLog : Wiki

More blog from David on MSN Spaces

dornstein — Sat, 04 Dec 2004 01:24:00 GMT

So MSN just launched a beta sevrice called Spaces which is a pretty soup'd up blogging environment. I've been playing with it for the past few days and it's pretty nice. I'm at least going to keep my personal blog over there and I am seriosly considering moving my work and FlexWiki-related blogging over there, too.

Here is my new blog.

Another example of using WikiTalk: page visit breadcrumbs in FlexWiki

dornstein — Fri, 08 Oct 2004 15:46:00 GMT

I have now documented the recent checkin supporting "Visitor Events". These are WikiTalk-accessible objects that can be used to show a history of the pages visited by a user during their session at a FlexWiki site.

I’ve also incorporated this into the standard page borders on http://www.flexwiki.com, so you can see it in action.

A more detailed explanation is here: http://www.flexwiki.com/default.aspx/FlexWiki.VisitorEventDemo

FlexWiki customizable borders now well-documented

dornstein — Sun, 03 Oct 2004 04:41:00 GMT

I finally go around to writing up some solid documentation describing all the ways that that the borders on a FlexWiki page can be customized.

OK, time to drive to a SolidRelease

dornstein — Sat, 02 Oct 2004 21:13:00 GMT

Now that FlexWiki has moved back into gear after the release to SourceForge last week, it's time to gather round and drive FlexWiki to a SolidRelease. What do I mean by that? Well, there are lots of bug reports and lots of features that people have been requesting for a while now. I want to gather together interested developers and do something about that backlog: fix the important bugs and get some of the features in, too.

Partly this is just to get a SolidRelease so that people who just want to just download and use FlexWiki can do it without being annoyed by the bugs that are in there. More than that, though, I want to use this as a way to help developers learn about FlexWiki and how it works. There have been lots of people stopping by flexwiki.com who are interested in making changes to FlexWiki as well as learning and using its features (especially WikiTalk). Since the time I can spend on FlexWiki is limited, I haven't been able to answer all the questions on FlexWiki. So... I want to use this as an opportunity to help people learn about FlexWiki. If there's a concentrated group of people working over a concentrated period of time, I'll be able to put in the extra time and energy to help those involved come up to speed on any aspect of FlexWiki that they're working on. That's my deal: you help out and I'll help you learn and use FlexWiki.

You can find out more (and help define the project!) at SolidReleaseProjectHome. And even if you're not a developer, you can help out with the project by contributing ten minutes to the TrackerMigration.

Nice use of FlexWiki as a Bliki

dornstein — Thu, 30 Sep 2004 19:01:00 GMT

Very nice use of FlexWiki as a Bliki: http://bliki.salamandersoftware.co.uk/. Nice use of WikiTalk.

Well, that wasn't so bad...

dornstein — Wed, 29 Sep 2004 07:10:00 GMT

OK. So I am a bit tired but the chaos wasn't as bad as I'd imagined.

We launched FlexWiki on SourceForge yesterday (or was it today?). A few hours earlier than expected. That caused a bit of a scramble, but in the end it was no big deal.

I spent some time today reading the news coverage (c|net, InfoWorld, TechWeb, eWeek, Press Release, NewsFactor) and people's blogs (Rob, iGeek) about FlexWiki -- and, of course, Microsoft and open source. Interesting reading; no big surprises. A fair number of people out there seem to be trying to read the tea leaves of the FlexWiki announcement to find indicators of a deeper Microsoft strategy (plot?) related to Open Source. My take on that: relax, it's just tea; enjoy it for what it is. Tea. Just tea.

Pretty much as I expected, the SlashDot community did three things: (1) hit the site with a lot of traffic; (2) react in an immature way; (3) react in a mature way. The site (http://www.flexwiki.com) managed to hold its own during the heaviest load, though there were some blips of "Service Unavailable." That's OK; it's beta software; it's got bugs :-) We were up for 98% of the day, though, with fairly good responsiveness.

#2 and #3 pretty much cancelled each other out...

We did end up dealing with a pile of Wiki Vandalism. Which was a bit annoying, but not the end of the world. Lots of junk posted on various pages -- and then cleaned up pretty quickly by members of the community. Which is just how it's supposed to work. It's funny because it seems like an environment in which anybody can change anything would be a recipe for chaos. But with the exception of some occasional invasions by people who seem to have nothing better to do than demonstrate that, yes, it's a wiki and yes, anybody can change anything, the site has held together pretty well. Thanks to the folks in the community who have helped keep this under control. Of course, we've also used a few tricks to make this work well (which I'll write about some other time :-))

I also spent a bunch of time today building out a reasonably full set of topics for people interested in being developors on the FlexWiki project. I started with some really excellent material that Craig Andera wrote up and then added in some of my own material and organization and have produced a single landing pad for FlexWiki developers: the DeveloperHome.

FlexWiki posted to SourceForge.net

dornstein — Tue, 28 Sep 2004 03:44:00 GMT

This evening FlexWiki took the next step in its life and has been made available at SourceForge.net under the Common Public License. With this step, the developer community will have the latest source (including all the WikiTalk features), better access, better tools, and a better legal environment. The FlexWiki developer community has kinda stalled out a bit over the past few months as I've worked to get FlexWiki to this point. Now we can really get going again!

As I was thinking about what I'd write in the blog entry, I found myself enumerating questions that I thought people would have. So, I'm going to use question and answer form to talk this through. It's been a pretty exhausting process getting ready for tonight (not to mention the hard work going on in my "real" job at Microsoft and my fabulous, but recently sick family). If I've missed something important, forgive me - or better yet, let me know.

Why am I doing this?

So if it was exhausting, you might ask: why are you doing it? Well... for me it's all about the FlexWiki experiment. I've spent a lot of time on a lot of projects over the years and there are a set of things that I've seen cause pain and suffering consistently throughout. It's always seemed to me like a number of those things could be addressed by Wiki (e.g., not enough communication, a lack of a shared vocabulary, tools that are too heavy and get in the way of collaboration, no record of project history). That's what originally motivated me to build FlexWiki, starting last year here at Microsoft with Chris Anderson and proceeding, well, through today :-)

I wanted to test my hypothesis that Wiki could help. There's no question that, at first glance, it seems like Wiki could (help) solve many of these problems. But Wiki's got some downsides of its own. And there's a real honeymoon period, too. So the real questions was: could a good enough Wiki implementation really improve the software development process here at Microsoft? That's the FlexWiki experiment -- for me, anyway.

I still don't think I really know the answer yet, though the indications are good. Regardless, a funny thing happened on the way to an answer - lots of other people (both inside and outside Microsoft) got interested.

There are a bunch of teams inside Microsoft using FlexWiki now (unknowingly participating in my mad science experiment -- heh heh). And after repeated requests, I also made the code for the early version of FlexWiki available on GotDotNet and people started using it and contributing to it. In the meantime, FlexWiki has had some nice successes and more and more people want to both contribute as well as use FlexWiki. Which means it's time to scale up and take the next step with FlexWiki. Thus SourceForge.net and thus the Common Public License (CPL).

I don't know about FlexWiki, can you give me a summary?

FlexWiki is an implementation of Wiki, a web-based, collaborative writing environment. I wrote a lot (but not all!) of FlexWiki. While there are lot of Wiki implementations out there, this is a nice one because of its various features. FlexWiki is particularly designed to allow multiple teams focused on diverse, but related, projects to work in the same Wiki environment with multiple namespaces. This allows large groups of people to collaborate more easily. Additionally, FlexWiki supports a new, fully integrated, scripting language - WikiTalk. WikiTalk enables content contributors to access .NET framework objects for dynamic content while working within the traditional Wiki environment and it allows .NET developers to easily expose rich dynamic functionality to writers of Wiki content. For a quick jumping off point about FlexWiki overall, check out http://www.flexwiki.com.

I've been following FlexWiki in the past, what's changing now?

A few simple things:

The source code is moving from its current host to SourceForge.net
The source code is licensed under the CPL and contributors need to agree new licensing terms described above
The latest sources -- including all the WikiTalk support is now checked in
We have a fantastic new continuous integration system that automated builds from the SourceForge.net CVS repository (thanks to the amazing efforts of Craig Andera [author of fwsync and FlexWikiPad] who has offered himself up to be FlexWiki buildmaster! Much karma goes his way.)

Why SourceForge.net?

Pretty easy answer. Actually three easy answers. First, WiX and WTL (the two projects that Microsoft has released like the company's doing today with FlexWiki under our Shared Source Initiative) have both been successful there. Second, SourceForge.net has a wide range of tools and services to support the developer community; many of these will be helpful as the FlexWiki development community continues to grow. Third, there are lots of Windows-related projects on SourceForge.net (I think it's over a third). This all adds up to a good strong place for the FlexWiki development community to land.

Why the Common Public License?

I'm not a lawyer and even though I find the law interesting and engaging, I'm not going to pretend that I am one. The advantages I see in releasing FlexWiki under the CPL going forward are: (1) it's a well-established license used by lots of people on lots of projects (including IBM); (2) it provides clear answers to many important questions left open to interpretation by many other "open source" licenses; and (3) it effectively addresses the right set of issues to enable individuals and companies to both contribute to the FlexWiki project as well as to comfortably use FlexWiki as a collaboration tool. This last one is really the most important one for me. I want to enable the broadest range of people to get their hands on FlexWiki, try it out, make it better, etc.

[Remember, it's all part of my "secret" experiment :-)]

You said "better legal environment" above. What did you mean?

As part of this change with FlexWiki, contributors to the project will assign ownership of their contribution to Microsoft and then, as part of the same agreement, we give it all back to them. This is pretty common practice for a bunch of important open source efforts (like the Free Software Foundation which does the same thing). The advantage here is that the project gets a single, clear copyright owner, etc. This is an example of the kind of "better legal environment" that I hope will make companies (even) more comfortable using and extending FlexWiki.

Thanks to early contributors Craig, Mike, Jan and Ryan for your contributions and agreeing to help FlexWiki grow.

What's next for the community?

Over the next couple of days, I'll write more about this, but I am hoping to rally the FlexWiki community around the idea of driving to a 1.0-level release. Right now, FlexWiki is really a strong beta. But it's got a pile of bugs and feature requests. Now that all the latest sources are available and we have good tools and such in place, I would like to gather a group of folks in the FlexWiki community together, identify the bugs we need to fix, the features we need to add and then work together to get it done. If you're interested in this work, let me know directly or join the FlexWiki users mailing list where I'll also post more info.

Call to action

So:

Grab the latest release of FlexWiki and try it out
Grab the sources and look around
Sign up for one or more of the FlexWiki mailing lists
Send me your comments and questions

In closing...

It's been a long road to get here. I first started working on trying to move FlexWiki into the world of Shared Source this spring. It's been a bit of a menagerie working together with folks inside Microsoft to get here today. The challenges have really been same same kind of challenges that exist doing something unusual in any big organization. But the people I've worked with - both making FlexWiki better and helping it get to today - made it much better and much easier than it would have been, I think, at most other places. People like Korby, Tommy, Omar, Jeff, Rob, (just to name a few with blogs). Thanks go especially to them (and to some others who have, perhaps, the good sense not to have blogs :-)).

And thanks to Ward for starting it all a long time ago...

AP: 'Wikis' Offer Knowledge-Sharing Online

dornstein — Mon, 27 Sep 2004 22:06:00 GMT

The Associated Press yesterday posted a nice (and accurate) positive article profiling Wiki technology and touting that, "Wikis are poised to become what blogs have turned into — still in the Internet avant garde yet widespread enough to be influential."

Finally, Firefox improvements for FlexWiki

dornstein — Mon, 27 Sep 2004 03:15:00 GMT

OK, I finally found some time to address many, but not all of the annoying and lingering problems using FlexWiki with Firefox. This came partly down to CSS work and partly down to how script and forms all fit together in the initial implementation of the topic editing page. I've gotten the two major Firefox problems fixed now (font sizes and the edit page working). There are a few other minor things I got working, too.

There are two features that you get in Internet Explorer, but not in Firefox yet: TopicTips and the TopicBar. These are nice features of FlexWiki, but not essential to its operation. There's no principled technical reason why these don't work yet; just time :-)

This is running live on FlexWiki.com and will be available in build 1593 (available at flexwiki.com within a few days).

40 people port a book to Wiki!

dornstein — Fri, 30 Jul 2004 17:13:00 GMT

Wow. Go away on vacation and look what happens...

A group of about 40 people spent a weekend and ported Keith Brown's book The .NET Developer's Guide to Windows Security to a FlexWiki site here. Very sweet.

Part of the pluralsight.com FlexWiki site that's got material from Don Box, Craig Andera and Keith Brown.

I love discovering people who are using FlexWiki that I don't know about. It's clearly outgrown my ability to keep track of all the juicy things people are doing. If you know about cool places that FlexWiki is being used, please do try to add them to the IUseIt topic on flexwiki.com.

WikiTalk almost mainstream...

dornstein — Mon, 19 Apr 2004 22:57:00 GMT

Today I released a new build of FlexWiki. It's got some improvements (see the list of things included in ReleaseNotes1569). More importantly, it's the first officially mainstream build of FlexWiki with WikiTalk; WikiTalk is no longer in experimental builds only.

I still don't have all this stuff checked in yet (yeah, I know, I need to get it done). I also really need to write more documentation for WikiTalk...

New Experimental FlexWiki build -- and some new features

dornstein — Tue, 13 Apr 2004 00:40:00 GMT

I've posted a new WikiTalkExperimentalBuild on www.flexwiki.com. This is the software that's now live on the site. This includes everything needed to make the full FlexWiki UI be based on WikiTalk -- the original goal of the WikiTalk project. I've started to do the documenting of the new features involved (both directly WikiTalk and related features that I had to build along the way -- including TopicBorders and advanced TableFormatting). More over the next couple of days as I have time.

Whoops! That bug was fun (or "Wiki vandalism by google!")

dornstein — Mon, 12 Apr 2004 19:11:00 GMT

OK. Time for a funny bug story.

Yesterday I upgraded the running version of FlexWiki at flexwiki.com to the newest bits from my development environment. It's the first time that the whole FlexWiki UI is built using WikiTalk. I'll be posting information more information about WikiTalk and the new WikiBorders feature over the next day or two. But anyway...

One of the UI changes is that the list of old versions of a topic are no longer listed in a drop-down with a button to show one. Now they're links on the page. Which means that web spiders follow them. Further, on each historical version of the page is (er, was :-)) a link that will restore the historical version and make it the latest again. Being links, of course, means that -- you guessed it -- web spiders will follow them.

All of this was compounded by an older bug that prevented the NOINDEX, NOFOLLOW instructions for spiders to be correctly emitted.

So...

This morning we awoke to find that lots of pages on flexwiki.com had been rolled back to previous versions. Wiki vandalism? Proof that people hate us?

Nope. Just google doing its job.

Anyway, it's should be fixed in the next few minutes...

Oh, if only this were my real job! :-)

dornstein — Mon, 05 Apr 2004 06:24:00 GMT

It's kinda embarrassing. On the WhoIsWorkignOnWhat page on flexwiki.com, I said I’d be done with all this WikiTalk stuff in January. And I’m still not done. :-(

On the other hand, I’ve been doing it in the evenings with a new baby in the house. And it’s getting pretty close. And I’m really happy about the results.

I’m starting to be able to do the real things that drove the project in the first place. The whole idea was that it should be possible to write the whole UI for FlexWiki using the Wiki model – and WikiText. And you should be able to have dynamic information in the UI about the topics themselves (for example, a list of related topics, etc.).

I spent a long time getting the WikiTalk language going and then spent a bunch of time working on integrating it into the system so you could use it from within Wiki pages. Now, I’m close to the finish line. I can see it. And I can smell it.

This weekend, I added TopicBorders. These are common borders for a topic (or a group of related topics). And on these borders is all of the UI for the site plus whatever individual topics or groups of topics want to stick there. All written in WikiText. Including, of course, WikiTalk.

Hooooooo haaaaaaaa!

Check out this screen shot. It shows the new FlexWiki UI built entirely using WikiTalk.

http://www.flexwiki.com/files/david/wikitalkui.jpeg

I hope to upload a new build with these features in the next day or two.

I’ve got to go back to my real job, tomorrow, though. Which isn’t bad at all. In fact, I love my real job.

Wiki is cool, too, though.

WikiTalk is born (or at least we're driving quickly towards the hospital!)

dornstein — Sun, 21 Mar 2004 04:20:00 GMT

OK. I've started to post information about WikiTalk, my new object-oriented language for FlexWiki. It's probably going to talk another few days to get the documentation usable and it'll likely be another few days after that before I post the binaries (and then a week after that when I actually checkin). However, the build on www.flexwiki.com is live with the first version of WikiTalk (thought it's really 0.9). Read more about WikiTalk here.

This has been a blast so far: starting with the concept, writing the lexical analyzer, hand-coding the parser, building the interpreter and using reflection to ties the object system together. It's enough to make me think about going back to writing code for a living :-)