Welcome to MSDN Blogs Sign in | Join | Help

Office Online -- now powered by AP!

Last week a new AP-based version of Office Online went live. 100% of assistance queries, TOC, and feedback are now handled by AP. You can check it out by using Office Online help in Office 2003 or by searching at http://office.microsoft.com.

What's better about it? The most obvious thing is performance--I think you'll be very pleased with the immediate response you now get--most customers have reported a huge performance improvement. Perhaps less obvious, but no less important is search relevance, which should start out great and get better over time based on user feedback.

Enjoy!

 

 

Posted by apblog | 13 Comments

AP Client and Server betas released!

Windows Vista (TM) Beta 1 contains a beta version of the Assistance Platform (AP) Client 1.0 help engine. All the content displayed in the new Help pane is authored according to the MAML XML schema. Also note that if you choose to get the latest online content, that content is downloaded to the local machine as MAML and transformed at runtime into HTML for display, just as the local content is. There's also a beta version of a new website that serves the same MAML content (also transformed at runtime) for the Web browser experience. You can check it out at http://windowshelp.microsoft.com. And another AP site has also just come on line: Windows Server TechCenter Beta Site at http://technet2.microsoft.com/windowsserver. These are the first betas of the AP Server.

Note that each content page also contains a feedback area that asks whether the content is useful (if you are viewing connected content). This feeds back into the AP analysis mechanism and results in reports that authors and editorial folks can use to focus their teams' efforts on the right areas.

Just a beta, but it's a start. What do you think?

 

Posted by apblog | 4 Comments

Security Update for HTML Help released today

This is a heads up that a new version of HTML Help has been released on Windows Update today to address a security issue. You can find more details in the bulletin at http://www.microsoft.com/technet/security/bulletin/ms05-026.mspx and the KB article at http://support.microsoft.com/kb/896358. You'll want to pay particular attention to the KB article, which documents potential application compatibility issues and their workarounds, when available.

Here's the text from the Windows Update item:

Security Update for Windows XP (KB896358)

A security issue has been identified in the HTML Help component that could allow an attacker to compromise your Windows-based system and gain control over it. You can help protect your computer by installing this update from Microsoft. After you install this item, you may have to restart your computer.

Posted by apblog | 11 Comments

Deprecating WinHelp

Thanks for all the feedback (and keep it coming)! Yes, we'll think long and hard before doing anything (as we already are/have), and yes, there is a big cost to keeping WinHelp on life support. This is not something we take lightly or do on a whim (if it was, WinHelp would have been oh so gone a long time ago). We know that application compatibility is important.

Oh, before continuing, I should point out that today's post contains the unadulterated opinions of ShaneMc. The views expressed are entirely his and are not necessarily those of Microsoft, the AP Team, or our sponsors.

For fun [hey, it's raining; what else 're we gonna do?], let's look at the definition of "deprecate" from the Encarta dictionary (http://encarta.msn.com/dictionary_/deprecate.html):

dep·re·cate [ dépprə kàyt ] (past dep·re·cat·ed, past participle dep·re·cat·ed, present participle dep·re·cat·ing, 3rd person present singular dep·re·cates)

transitive verb  deplore: to express condemnation of something or somebody
[Early 17th century. From Latin deprecari , literally “to pray against,” from precari  (see pray).]

The literal Latin translation of deprecari is probably closest to my own personal feelings about WinHelp. :-) [remember this is ShaneMc's opinion and does not necessarily represent the views of other AP representatives or Microsoft].

But the common use of this term in our industry is more as a warning of something that is going to go away sometime so you should stop using it. WinHelp falls into this category. When will it go away, you ask? I can't tell you at this time (simply because I don't know); all I can do is continue to warn you (as I have for a number of years) that it will go away. And beg you, please, to stop using it. It's possible that it will go away sooner rather than later--the increasing importance of Security may put a stake through its heart. Localization issues have driven WinHelp out of Microsoft products, even for popups. Usability and discoverability problems have led us away from What's This? help and toward a more task-oriented model. When the next version of Windows ships, there will be no .HLP files present on the CD. Nor will there be any What's This? help (even using HTML Help). The What's This? handler will still be there, but Windows won't be using it.

I totally get the argument for application compatibility and legacy WinHelp, and it's probably unlikely that WinHelp will be removed from Windows codename Longhorn. But really, I'm begging you: please don't create new WinHelp content and apps that use it. You're painting yourself into a corner if you continue to do so. I'm hereby personally deprecating WinHelp, both in the dictionary meaning above and in the common industry meaning. [Note that I have no responsibility in deciding whether WinHelp will actually be removed from Windows; I'm just a voice crying out in the wilderness]. The end of the WinHelp world is coming--we just don't know when yet.

Posted by apblog | 24 Comments

Can you imagine a world without WinHelp?

What if WinHelp didn't exist in Windows codename Longhorn? I'm talking specifically about the WinHelp() API and associated 15 year old technology). Yeah, yeah, I know--no rich popups for dialogs; some applications still use WinHelp, etc. But really, take a moment. How bad would it be? I'm not just asking how bad you think it would be, but give me data and examples: What would break? Who would care (besides WinHelp experts)? How many Windows customers would be affected?

Consider the good things, too. Higher security. One less format to worry about (and for HAT vendors and MVPs, support). A whole world of workarounds you'd never have to do anymore. More of your feature requests satisfied in AP v2 because we don't have to spend as much time maintaining the old code base. 

What if the 16-bit version of WinHelp stayed and only the 32-bit version was removed? What would it take for you to give up your WinHelp habit?

Yes, I know this is controversial, but hey this blog is about two way communication and yes, I do expect to hear from you. :-)

 

Posted by apblog | 27 Comments

XML, MAML, and Adaptive Content

The comments for yesterday's post included a request for conditional content. Content for AP Client is authored as XML using a schema called MAML (Microsoft Assistance Markup Language). Originally we thought we'd rename the schema (and we still may), but it has sort of stuck. In any case, MAML is a schema that is designed specifically to support assistance content and nothing more. More info on this later, but for now I just want to point out that many of the elements of MAML can take a "condition" attribute that lets the author specify a user/machine state condition that will control whether the content should be shown to the user (it's evaluated dynamically at display time). For Longhorn there will be only a small number of conditions, but this will likely grow in future versions.
Posted by apblog | 16 Comments

When can you use the new Assistance Platform?

The first distribution of AP Client bits will be in Windows codename "Longhorn", but for that release AP will be the help engine for the operating system only. By that I mean that this will not be a general purpose Help engine that third parties (you) can use to provide your own help for your own applications. This was a very difficult decision for us. The main reason is that we had clear feedback from the last PDC and from WritersUA in 2004 that in order to adopt a new Help engine, you need it to run on more versions of Windows than just Longhorn. The rearchitecture this required ate into our schedule such that we had to limit extensibility for this first release, but we are set up in good position to better meet your needs in the future. While it is not Microsoft policy to comment on unannounced products, it is important to us (even personally) to release a general purpose Help engine as soon as we can.

Breathholding is not advised, but we are working on it. :-) 

Posted by apblog | 34 Comments

Welcome to the Assistance Platform Team Blog!

What is the Assistance Platform (AP) Team? We're a team that is focused on providing a great Help experience for Windows users. Our first deliverables will be new assistance Web sites for Windows and the new Help experience in Windows codename “Longhorn”. The team previously known as the Microsoft Help team is part of the AP team, but our charter goes beyond the old client-based assistance model. This includes AP Client, Server, Authoring, Publishing, and Analysis.

In addition to new Assistance Platform technology, our team owns WinHelp (legacy RTF-based Help), HTML Help 1.x (the current general purpose Help system), Microsoft Help 2.x (the Help engine in Visual Studio and MSDN), Communities infrastructure, and enhancements to the search that currently powers TechNet and MSDN Online.

For those of you interested in Help/Assistance technologies, we hope this blog will be a useful and informative source.

Cheers,

The AP Team

Posted by apblog | 37 Comments
 
Page view tracker