Bill Buchanan

Using the March CTP I've compiled help for chm and html. I copy the html to my web site with a link. The help has a number of samples and good information that I would like to be accessible through a Google or MSN Search, although it appears that neither have picked up any of my documentation. MSN still has copies of my nDoc documentation that has been gone for 6 months, but no sign of Sandcastle documentation.

I feel like I've missed something very basic.



Re: Developer Documentation and Help System Search Engine friendly output?

Anand Raman - MSFT

Bill,

This is very interesting. Can you point me to your website. We probably are missing some search metadata/keywords which are typically added seperately with our internal documentation process.

Anand..






Re: Developer Documentation and Help System Search Engine friendly output?

Bill Buchanan

Anand,

Thanks for the response. I don't think you have to add any keywords to make sure that your site is searched, it seems like you'd have to go out of your way to make sure it's not searched. I wonder if it's because of the frames

Anyway, you can see our documentation at http://www.rightedgesystems.com/documentation/developerguide/index.html

Thank you.





Re: Developer Documentation and Help System Search Engine friendly output?

Stephan Smetsers

I agree.

The online documentation of the inchl framework uses a frameset and its being index by google without any problems. The update frequency of google depends on how often your site is being searched (using google) and the amount of links that are made from others sites (PageRank)

PageRank Explained

PageRank relies on the uniquely democratic nature of the web by using its vast link structure as an indicator of an individual page's value. In essence, Google interprets a link from page A to page B as a vote, by page A, for page B. But, Google looks at considerably more than the sheer volume of votes, or links a page receives; for example, it also analyzes the page that casts the vote. Votes cast by pages that are themselves "important" weigh more heavily and help to make other pages "important." Using these and other factors, Google provides its views on pages' relative importance.

Of course, important pages mean nothing to you if they don't match your query. So, Google combines PageRank with sophisticated text-matching techniques to find pages that are both important and relevant to your search. Google goes far beyond the number of times a term appears on a page and examines dozens of aspects of the page's content (and the content of the pages linking to it) to determine if it's a good match for your query.

(copied from http://www.google.com/technology/index.html)

Kind regards,

Stephan Smetsers

stephansmetsers@hotmail.com

http://www.inchl.nl





Re: Developer Documentation and Help System Search Engine friendly output?

Bill Buchanan

Sorry, I don't quite follow you. What were you agreeing with exactly

I'm also interested in the inchl framework you speak of. Is this another tool I need to use to make different types of output pages





Re: Developer Documentation and Help System Search Engine friendly output?

EWoodruff

I don't think the frameset would affect it. It's probably more a function of how many other pages link to it. If you don't have any links to it from your main website or your site hasn't been crawled in awhile that might explain it. You can probably check your web logs to find out that.

Eric





Re: Developer Documentation and Help System Search Engine friendly output?

Stephan Smetsers

I agreed with the fact that Microsoft does not have to put any effort in making the documentation more indexable for google.

The website is just not indexed enough (pagerank) by google because its populairity is low. :-P

The inchl framework does not have anything to do with documentation of .NET assemblies, but its online documentation (reference library) is generated using Microsoft's Sandcastle. Currently google has indexed it a few times and the Sandcaslte generated output can be found using simple google keywords without any problems.

Stephan





Re: Developer Documentation and Help System Search Engine friendly output?

Bill Buchanan

So it sounds like the conculsion is, I just haven't been crawled after 6 months or somehow it just hasn't crawled to my main documentation page. Hrm. There has been a link to the documentation from the main site for quite some time as it was with the nDoc. I'm confused. I can accept this though if it's working for other folks who have sandcastle generated documentation that has been indexed.

Thank you folks.