On Tue, 02 Jun 2015 08:31:30 +0200
Jacob Carlborg via Digitalmars-d <digitalmars-d@puremagic.com> wrote:

> On 2015-06-01 18:38, Atila Neves wrote:
> > I think I've addressed all comments now, except for Robert's one on whether or not multi-threading should be on by default. Also, after much toiling I've managed to get the docs up here:
> >
> > http://atilaneves.github.io/phobos/phobos/std_experimental_testing.html
> >
> > It really should be a lot easier to generate the docs. Anyway, please give it a look and destroy away.
> 
> I would like to have some more documentation, some more examples how to use this.
> 
> I think all UDA's should start with a lowercase character.
> 

I think all UDA's should start with a uppercase character ;-).
(It is much easier to distinguish between UDAs and non-UDAs(@nogc,
@safe, @property ...))

On Tuesday, 2 June 2015 at 06:31:14 UTC, Jacob Carlborg wrote:
> On 2015-06-01 18:38, Atila Neves wrote:
>> I think I've addressed all comments now, except for Robert's one on
>> whether or not multi-threading should be on by default. Also, after much
>> toiling I've managed to get the docs up here:
>>
>> http://atilaneves.github.io/phobos/phobos/std_experimental_testing.html
>>
>> It really should be a lot easier to generate the docs. Anyway, please
>> give it a look and destroy away.
>
> I would like to have some more documentation, some more examples how to use this.

Especially the main page needs some more links and at best a first example of the kicker features of the package.

By links I mean pure conveniance, see how far down the left the package is located :D

> I think all UDA's should start with a lowercase character.

On Tuesday, 2 June 2015 at 06:31:14 UTC, Jacob Carlborg wrote:
> On 2015-06-01 18:38, Atila Neves wrote:
>> I think I've addressed all comments now, except for Robert's one on
>> whether or not multi-threading should be on by default. Also, after much
>> toiling I've managed to get the docs up here:
>>
>> http://atilaneves.github.io/phobos/phobos/std_experimental_testing.html
>>
>> It really should be a lot easier to generate the docs. Anyway, please
>> give it a look and destroy away.
>
> I would like to have some more documentation, some more examples how to use this.

Oh yeah, that's a complaint I heard at DConf. I should definitely work on that.

>
> I think all UDA's should start with a lowercase character.

Why?

Atila

On Tuesday, 2 June 2015 at 08:51:11 UTC, extrawurst wrote:
> On Tuesday, 2 June 2015 at 06:31:14 UTC, Jacob Carlborg wrote:
>> On 2015-06-01 18:38, Atila Neves wrote:
>>> I think I've addressed all comments now, except for Robert's one on
>>> whether or not multi-threading should be on by default. Also, after much
>>> toiling I've managed to get the docs up here:
>>>
>>> http://atilaneves.github.io/phobos/phobos/std_experimental_testing.html
>>>
>>> It really should be a lot easier to generate the docs. Anyway, please
>>> give it a look and destroy away.
>>
>> I would like to have some more documentation, some more examples how to use this.
>
> Especially the main page needs some more links and at best a first example of the kicker features of the package.
>
> By links I mean pure conveniance, see how far down the left the package is located :D

There was an issue with the dlang.org repository and it didn't generate the usual navigation on the left. I'll see if it's been fixed in the meanwhile and update it.

Like I said before, generating the docs should be a lot easier than it is now.

Atila

On Tuesday, 2 June 2015 at 09:13:49 UTC, Atila Neves wrote:
> On Tuesday, 2 June 2015 at 08:51:11 UTC, extrawurst wrote:
>> On Tuesday, 2 June 2015 at 06:31:14 UTC, Jacob Carlborg wrote:
>>> On 2015-06-01 18:38, Atila Neves wrote:
>>>> I think I've addressed all comments now, except for Robert's one on
>>>> whether or not multi-threading should be on by default. Also, after much
>>>> toiling I've managed to get the docs up here:
>>>>
>>>> http://atilaneves.github.io/phobos/phobos/std_experimental_testing.html
>>>>
>>>> It really should be a lot easier to generate the docs. Anyway, please
>>>> give it a look and destroy away.
>>>
>>> I would like to have some more documentation, some more examples how to use this.
>>
>> Especially the main page needs some more links and at best a first example of the kicker features of the package.
>>
>> By links I mean pure conveniance, see how far down the left the package is located :D
>
> There was an issue with the dlang.org repository and it didn't generate the usual navigation on the left. I'll see if it's been fixed in the meanwhile and update it.
>
> Like I said before, generating the docs should be a lot easier than it is now.

Should work now.

Atila

On 2015-06-02 11:12, Atila Neves wrote:

> Why?

Because I think it's looks better :). It's also same standard as the built-in attributes are using.

-- 
/Jacob Carlborg

On Tuesday, 2 June 2015 at 19:54:49 UTC, Jacob Carlborg wrote:
> On 2015-06-02 11:12, Atila Neves wrote:
>
>> Why?
>
> Because I think it's looks better :). It's also same standard as the built-in attributes are using.

Changed them to lower case, added examples and updated the docs.

Atila

On Tuesday, 2 June 2015 at 20:50:13 UTC, Atila Neves wrote:
> Changed them to lower case, added examples and updated the docs.
>
> Atila


The docs look nice. As far as I can tell, this should cover at least 75% (for me it is more like 95%) of what people want and is not built-in.

On 2015-04-20 15:28, Atila Neves wrote:
> Original library: http://code.dlang.org/packages/unit-threaded
> PR: https://github.com/D-Programming-Language/phobos/pull/3207

* Would it be possible to make the "should" functions more composeable. Instead of "a.shouldEqual(b)" something like "a.should.equal(b)". Then you don't need a separate "shouldNot" function for all functions, just one

* Is it possible to create custom "should functions" or marchers as RSpec would call them? Otherwise perhaps the above suggestion would make that easier

* I would recommend writing the actual operator used for a given "should function" in the documentation

* Is there a function to compare if two objects are the actual same objects in memory, i.e. comparing using "is"?

* Latest versions of RSpec does not allow to specify an exception type when a test should not throw an exception. I don't recall the exact reason now but it might be worth investigating and taking in to consideration

* Is there any special output when running the tests? In that case, how does it look like? Is it possible to use different formatters for the output and create custom ones?

-- 
/Jacob Carlborg

On 2015-04-20 15:28, Atila Neves wrote:
> Original library: http://code.dlang.org/packages/unit-threaded
> PR: https://github.com/D-Programming-Language/phobos/pull/3207

No Cucumber tests? This is what you're up against [1] ;). I think the Cucumber tests in RSpec are a perfect example of how to use Cucumber correctly. And this Relish site is able to generate good looking documentation based on Cucumber feature files.

[1] http://www.relishapp.com/rspec/rspec-core/docs

-- 
/Jacob Carlborg