The 7.x-1.2 release seems to be messed. I went here /admin/settings/seo_checker as per the docs here:
http://drupalcode.org/project/seo_checker.git/blob/refs/heads/master:/IN...

But it really should be here:
/admin/config/content/seo_checker

I didn't see it in /admin/config/ when I first installed it, but not sure why.

Having a doc page like really isn't that useful:
admin/advanced_help/seo_checker

It really should be more about how to a generic user would actually use this functionality in their site. I am confident that a slim minority of our clients would find this useful. Most would be terrified if they saw this. This isn't at all user friendly and I don't think that is by design.

In editing a node, I don't know where to set the keywords, why title tags are important. How should I use this module to improve my SEO? This should be spelled out. There are lots of assumptions here.

Alt attributes in Only local images are allowed. - tags	Test passed.	100%	≥ 100%	
Title attributes in  - tags	Test failed, please make sure your links contain a title attribute.	0%	≥ 20%	
Keyword density in the body	Test failed, please make sure you use your keywords in the body but not too often.	2%	∈ [5%,20%]	
Usage of keywords in node titles	Test failed, place your keywords early in your node title.	20%	≥ 50%	
Usage of keywords in headings	Test passed.	100%	≥ 50%	

I'm also not new to Drupal, but this exchange here is really much more obnoxious than I'm used to in this community:
#1214652: is there any info how to setup this module

I've not had any exchanges that I can remember with either @WorldFallz or @fender before. I realize that this is a new thread that's part of a discussion elsewhere, but I'd really like to see a more constructive discussion in the issue queue.

Comments

mgifford’s picture

Category: bug » task
Issue tags: +Documentation

Changing this to a task. I'd actually be fine with just re-opening @fender's issue. Docs on setting up this module need to be improved.

miruoss’s picture

Component: SEO Checker (Code) » Documentation
Assigned: Unassigned » miruoss

Thanks for your feedback.

I see your point. My module really is not enough documented. And when I adapted the module from Drupal 6 to Drupal 7 I forgot to change paths and some details in the INSTALL.txt. I will update it. And actually, I didn't know the advanced_help module shows my README.txt. I will rename the files so that it's clear that the information you're referring is for developers.

However, it is not my intention to explain you the SEO techniques in this module. There's enough information on the web about why title tags are important and other SEO rules. This module just helps you / tells you what to do to comply with them.

As for the other issue opened by fender: As long as requests,feedbacks,discussions in my issues are being constructive I sooner or later invest my time in them. But when people say the module is 10% done and tell me what I HAVE TO do I just don't have anything to say. I invest my free time for this module and there are times when I just don't have that much of it left. Everybody is free to use the module.

mgifford’s picture

Absolutely.. Your module is definitely more than 10% done. All software is a work in progress. Documentation is an issue with the software industry in general. That being said, if someone complains about there not being documentation it's a good space to suggest that this is a great place for them to contribute to it.

It's really difficult to maintain any piece of software as much as we'd like. There really need to be more incentives in place to make it easier for developers to be able to justify spending more time on the code they contribute. There's only so much that any of us can give back to the community. As a community we have to think more long term about how we keep our community involved but not burnt out. So important to spend time away from computers..

I'm not new to SEO or drupal and I'm still a bit puzzled by your module. I'm hoping my questions can help lead to some documentation. Part of the problem about SEO is that there are just so many opinions out there that it's hard to track down what the bots actually care about. I tried to search specifically for the titles & links issue and got a lot of hits from before 2009. Maybe this is still relevant, but I'd much rather trust an article that did some testing from late 2010.

Part of what I'm puzzled by (and heck maybe it's in some of the docs) is where the keywords are defined. I understand the importance of keywords, but where has your module defined that? Maybe I'm just lacking a practical workflow of how you've used this module to improve your site's SEO.

Probably unrelated, but I had this vision today of setting up a simple jQuery script to automatically populate the title attribute by simply calling out & inserting the page title from the URL. You'd really want to do this when editing the link rather than viewing the page, but I haven't seen any tools to help assist page intelligent text.