Foxtable(狐表)用户栏目专家坐堂 → [建议]移动开发 帮助文档急需完善


  共有8464人关注过本帖树形打印复制链接

主题:[建议]移动开发 帮助文档急需完善

帅哥哟,离线,有人找我吗?
jspta
  1楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:七尾狐 帖子:1731 积分:11255 威望:0 精华:0 注册:2011/12/15 22:06:00
  发帖心情 Post By:2017/5/25 13:10:00 [显示全部帖子]

吐槽下帮助吧,确实很丰富,但是没有抓住重点讲解。以这个网址作为例子
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.随着狐表帮助越来越强大,随之而来的就是碎片化,不连贯性,是不是该考虑,论坛用户参与到帮助编写的过程中了,毕竟以开发者写的帮助,一般用户时难以理解的。





 回到顶部