吐槽下帮助吧,确实很丰富,但是没有抓住重点讲解。以这个网址作为例子
http://www.foxtable.com/mobilehelp/scr/0245.htm
整个页面以 设置默认网页 为标题 通篇却没有讲哪句代码才是设置完成这个功能的关键。(实际上这种写法非常容易被忽略)
默认网页由e.Path = "" 时确定默认调取页面,因此
Dim wb As New WeUI '定义一个基于weui框架的网页生成器
if e.Path = "" then
wb.InsertHTML("这是默认页面addnew.htm")
else
Select Case e.Path
Case "addnew.htm"
wb.InsertHTML("这是默认页面addnew.htm")
Case "order.htm"
wb.InsertHTML("这是普通页面order.htm")
End Select
end if
e.WriteString(wb.Build) '生成网页
虽然以上代码比原来的复杂一点,但是把真正的关键点告诉了开发者,以后自己修改和扩展起来也会方便许多。
2.既然事件头那么通用,被你们强调了无数遍,为何不告诉用户规整到一个函数中或者你们自己写个通用帮助类给用户使用,然后专门开一个章节讲解这个帮助类,降低入门代码复杂度,也让希望提高的开发者升入学习。
3.随着狐表帮助越来越强大,随之而来的就是碎片化,不连贯性,是不是该考虑,论坛用户参与到帮助编写的过程中了,毕竟以开发者写的帮助,一般用户时难以理解的。