why there's no 'YOUR JOB' comments ( which are good tips helping people to know what to do ) in ble sdk 15 or ble mesh code?

[zzzh]

why there's no 'YOUR JOB' comments ( which are good tips helping people to know what to do ) in ble sdk 15 or ble mesh code?

[awneil]

Not sure what you mean by this?

The SDK examples are (intended to be) complete, so there are (or should be) no specific things that the user needs to do - just build, load, and run.

If you're looking to build upon the examples, see:

devzone.nordicsemi.com/.../nrf5-sdk-for-mesh-v2-2-0-light-switch-demo---where-next

[zzzh]

Hi, awneil,

Thanks for the reply and the link, I agree with that guy in the link, here's what he said: "It's like a car handbook which describes each cog in the gearbox in fine details - but doesn't tell you how to drive the car!"

That's exactly what I feel after did some reading on Nordic's SDK documentation, most of Nordic's clients are not going to build or repair the car( at least not at first ), they are going to drive it.

[awneil]

But that's not going to be solved by a few comments in the code - that's still down at the "individual cog" level.

[zzzh]

"YOUR JOB" in old SDK version are not just comments, they are more like handles to drive the car, that's why I think they are important.

Maybe as you say, it's still at "individual cog" level, but much better than nothing..

[zzzh]

I guess you are a Nordic guy, right?

Hopefully, Nordic would have a plan on this.

[awneil]

https://devzone.nordicsemi.com/backstage/f/welcome-to-the-devzone/30115/how-to-know-the-respondent-is-nordic-employee-or-not

[zzzh]

Got it, thank you.

[Bjørn Kvaale]

Like awneil mentioned, the examples are supposed to work out of the box. It seems like you are referring to more of a hands on tutorial if I understood correctly. We do have a few tutorials here & I can also recommend these ones by Bjørn Spockeli. You may also want to take a look at the Nordic Semi Playground on Github. Some of the tutorials are slightly outdated, so it may be better to use the ones made by Bjørn.

[zzzh]

What I mean is: Nordic should have some handles ( like "YOUR JOB" comments in old sdk code ) in their new sdk code so that people know where to focus when they want to change something for their application needs.

[Bjørn Kvaale]

Thank you for the feedback. I will mention this internally.

[zzzh]

Great, thank you.